Indexer API

List contracts

Every contract of the registry, its binding and the events the index keeps of it.

GET/v1/contracts

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 contracts.

contractsobject[]always present

namestringalways present

addressaddressalways present

bindingstringalways present

The SDKs' binding whose ABI decodes it.

eventsstring[]always present

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.

Shell

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

Try ittestnet · 46630

Example response

JSON

{
  "contracts": [
    {
      "name": "tapehouse.Band",
      "address": "0xCAB25d6C9460BEE96997A1Df664b14daC2c49359",
      "binding": "Band",
      "events": [
        "Anchored(bytes32,uint64,uint64,uint64)",
        "HaltSignerUpdated(address,address)"
      ]
    },
    {
      "name": "tapehouse.GapBackstop",
      "address": "0x32acef0BBCB78b88d82b672DFE3F325105dAEd8E",
      "binding": "GapBackstop",
      "events": [
        "Approval(address,address,uint256)",
        "CooldownStarted(address,uint256,uint64)"
      ]
    }
  ]
}