Indexer API

Get status

The chain, the block indexing started at, the index's head and the chain's finalized block.

GET/v1/status

View as Markdown Open in Claude Open in ChatGPT

The public tier allows 10 requests a second per client. Beyond it, send an X-API-Key or pay for each request in USDG. See the overview.

Response

200 The index's status.

chainIdintegeralways present

startintegeralways present

The earliest deployment of Tapehouse's contracts.

headHeadalways present

finalizedintegeralways present

Zero where the chain reports no finalized block.

Errors

401	An X-API-Key the operator did not issue.
402	Over the public tier's rate, where the operator sells the requests beyond it. The `PAYMENT-REQUIRED` header is the base64 of a JSON document of x402's version 2: what a request costs in USDG, and to whom, on which chain. Repeat the request with `PAYMENT-SIGNATURE`, the base64 of the payment signed for it; it is served once the payment settles, and its `PAYMENT-RESPONSE` header is the settlement.
429	Over the tier's rate.
503	Why the request was not served.

Shell

curl "https://indexer-production-f5dc.up.railway.app/v1/status"

Try ittestnet · 46630

Example response

JSON

{
  "chainId": 46630,
  "finalized": 134090867,
  "head": {
    "number": 134101529,
    "hash": "0xbe13644dcee16ef2feca3b0b68255a93e8c0429dc3b95a8f912ac377ac48f7df"
  },
  "start": 128723678
}