API Reference

OpenAPI schema at /api/openapi.json · Interactive docs at /api/docs

Rate limit: 120 req/min per IP. All endpoints return JSON unless noted. Admin endpoints require X-Admin-Token header.

Health & Stats

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

GET/api/stats/networkFull chain stats: hashrate, difficulty, mempool, connections

GET/api/stats/priceITC/USD price oracle

GET/api/stats/supplyCirculating supply with UTXO-set source + staleness flags

GET/api/stats/indexerIndexer phase + last indexed height

Scriptable Stat Endpoints

GET/api/hashrate120-block rolling hashrate — { hashrate, label, window_blocks }

GET/api/difficultyCurrent PoW difficulty — { difficulty, tip_height }

GET/api/blockcountCurrent tip height as a plain integer (widget-friendly)

GET/api/circulatingsupplyCirculating ITC as a plain decimal number (CMC/CoinGecko-compatible)

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 (ITSL)

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: block height, tx hash, address, token

Treasury Grant — Pool Rewards

GET/api/pools/snapshotsPublic list of approved reward snapshots (limit/offset)

GET/api/pools/snapshots/{id}Snapshot detail with per-pool entries

POST/api/pools/applyApply as a pool operator (creates a pending application)

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 active subscriptions

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

DELETE/api/webhooks/{id}Remove a subscription

SDK

npm install @interchained/vision-sdk

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