MempoolFeedResponse
| Field | Type | Required | Description |
|---|---|---|---|
data | MempoolFeed | Yes | The requested resource or collection; its schema is specific to this endpoint. |
Get complete network-local mempool
GET/v1/mempool/feed
Complete network-local Core observation, refreshed every five seconds, newest first. Every observed ID is returned without pagination. Missing total output is unavailable, never zero. Failed or stale observation is unavailable with null data. API response cache has a maximum 500 ms lifetime when the complete feed fits the cache item budget; oversized feeds bypass it without truncation. This feed is separate from confirmed history.
Example
curl 'https://api.tensorcash.org/v1/mempool/feed'Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
min_height | query | integer | — | Optional minimum serving indexed height. Returns DATA_NOT_READY if no eligible source has reached it. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful read from one Indexer snapshot | |
400 | Invalid argument or page conditions | |
401 | Authentication required | |
403 | Permission denied | |
404 | Absent in a ready indexed range | |
409 | Verified chain continuity invalidation | |
422 | Bounded response would exceed byte budget | |
429 | Quota exceeded; Retry-After supplied | |
503 | Data or eligible source not ready | |
504 | Bounded upstream query timed out |
Schemas
MempoolFeed
Complete network-local Core mempool observation, refreshed every five seconds and timed separately from confirmed chain state. All observed transaction IDs are included, newest first; transactions equals items.length. No pagination or sampling.
Type: object | object
MempoolFeedItem
One unconfirmed Core transaction. An unavailable output is not zero.
| Field | Type | Required | Description |
|---|---|---|---|
txid | string | Yes | 64-character hexadecimal transaction ID; searches accept either case. |
time | integer | Yes | Unix timestamp in seconds; mempool items use Core arrival time and confirmed items use block time. |
vsize | integer | Yes | Core virtual transaction size in bytes. |
total_output | MempoolOutput | Yes | Exact sum of all outputs of this transaction in TSC smallest units; never a fiat value. |
MempoolOutput
Type: object | object
Problem
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Problem type URI; about:blank is used for the current error family. |
title | string | Yes | Short human-readable problem title, normally the stable error code. |
status | integer | Yes | HTTP status code for this problem response. |
code | "INVALID_ARGUMENT" | "UNAUTHORIZED" | "FORBIDDEN" | "RESOURCE_NOT_FOUND" | "CHAIN_ANCHOR_INVALIDATED" | "RATE_LIMITED" | "DATA_NOT_READY" | "SERVICE_UNAVAILABLE" | "UPSTREAM_TIMEOUT" | "RESPONSE_TOO_LARGE" | "CORE_UNAVAILABLE" | "CORE_METHOD_UNAVAILABLE" | "CORE_DATA_NOT_READY" | "CORE_CAPACITY" | "TRANSACTION_CAPACITY" | "TRANSACTION_STATE_CHANGED" | "TRANSACTION_REJECTED" | "BROADCAST_OUTCOME_UNKNOWN" | "UNSUPPORTED_ASSET_POLICY" | Yes | Stable machine-readable error code; use this instead of matching message text. |
request_id | string | Yes | Identifier also supplied in X-Request-ID; include it when reporting an error. |
detail | string | — | Human-readable explanation of the error. |
retry_after_seconds | integer | — | Suggested wait in seconds before retrying; where present, agrees with Retry-After. |
- Source
- TSCScan public API v1.0.0 (12f98c5) · rHuhu · MIT
- OpenAPI spec (JSON)
- /docs/api/tscscan-v1.openapi.json