API Reference

The OpenAPI schema is also served at /api/openapi.json · Interactive docs at /api/docs.

Rate limit: 120 req/min per IP (configurable). All endpoints return JSON.

Health & Stats

GET/api/healthLiveness + connectivity to RPC, ElectrumX, Redis

GET/api/stats/networkAggregated chain stats (hashrate, difficulty, mempool)

GET/api/stats/priceITC/USD oracle (when configured)

GET/api/stats/indexerIndexer phase + last height

Blocks

GET/api/blocks/tipCurrent chain tip { height, hash }

GET/api/blocks?limit=&before_height=Paginated block list (newest first)

GET/api/block/{hashOrHeight}Block detail with coinbase + miner detection

Transactions

GET/api/tx/{txid}Transaction with input enrichment + fee calc

POST/api/tx/broadcastBroadcast a raw hex transaction

Addresses

GET/api/address/{addr}Balance + label + first/last seen

GET/api/address/{addr}/txsTransaction history (offset/limit)

GET/api/address/{addr}/utxosUnspent outputs

GET/api/address/{addr}/tokensITSL token holdings

Mempool

GET/api/mempool/summaryCounts, fee categories, fee histogram

GET/api/mempool/txsTop mempool transactions by fee rate

GET/api/mempool/projectedProjected upcoming blocks

Tokens

GET/api/tokensRegistry list with sort/filter/search

GET/api/token/{id}Token metadata + supply

GET/api/token/{id}/historyToken transfer history

GET/api/token/{id}/balance/{addr}Balance lookup

Deploy

POST/api/deploy/estimateEstimate the create-token fee

POST/api/deploySign + broadcast a createtoken (WIF in body)

Search

GET/api/search?q=Disambiguating search across heights, hashes, addresses, tokens

Real-time & Feeds

GET/api/sseServer-sent events: snapshot, block, mempool, ping

WS/api/wsWebSocket firehose (same payloads as SSE)

GET/api/feed/blocks.xmlAtom feed of recent blocks

Webhooks

GET/api/webhooksList subscriptions

POST/api/webhooksRegister a subscription { url, events[], secret? }

DELETE/api/webhooks/{id}Remove subscription

SDK

npm install @interchained/vision-sdk

import { VisionClient } from '@interchained/vision-sdk'
const v = new VisionClient({ baseUrl: 'https://explorer.interchained.org' })
const tip = await v.getTip()
v.subscribe('block', (b) => console.log('New block:', b.height))