API
Read-only JSON from this explorer's own node, free to use
Endpoints
| GET | Returns | Cached |
|---|---|---|
| /api/v1/status | Tip, finalized height and gap, BFT height, round and step, roster size, active stake | 2 s |
| /api/v1/finalizers | Every candidate with rank, signed name, voting power, share and signatures in the window | 10 s |
| /api/v1/finalizers/{key} | One finalizer: stake, reward bank, current vote and signed profile | 10 s |
| /api/v1/blocks?limit=20 | Latest blocks (up to 100) with finality and the BFT certificate each carries | 5 s |
| /api/v1/blocks/{height or hash} | One block with its transaction ids | 5 s, 1 h once final |
| /api/v1/decisions?limit=50 | Latest BFT decisions (up to 100) with the keys that signed each one | 10 s |
| /api/v1/staking?depth=500 | Staking actions in the last blocks (up to 500): bond, unbond, withdraw, retarget, convert | 15 s |
| /api/v1/snapshots | Published node snapshots with checksum, signature state and download links | 60 s |
| /api/v1/history | Block time, difficulty, signatures and rewards per 1,000 blocks, plus 15-minute samples of finality and stake | 60 s |
Conventions
- Envelope
- Every response is { ok, data, error }. Errors set ok to false and give a reason.
- Amounts
- In zats: 1 cTAZ is 100,000,000 zats. cTAZ is the feature net's test coin and has no value.
- Keys and hashes
- Lowercase hex. Block hashes in the usual display order; finalizer keys are 64 characters.
- Times
- Unix seconds.
Try it
curl -s https://crosslinkscan.org/api/v1/status
{
"ok": true,
"data": {
"network": "Crosslink Feature Net",
"tipHeight": 156512,
"finalHeight": 156506,
"finalityGap": 6,
"bft": { "height": 71840, "round": 0, "step": "Propose" },
"...": "..."
},
"error": null
}Example response; the values change with every block.
Limits and stability
- Rate
- 10 requests per second per address, with bursts of 40. Past that the answer is 429; wait a moment and retry.
- Browsers
- CORS is open, so pages on any site can call it directly.
- Versioning
- v1 only gains fields. Anything that would break a client goes to /api/v2.
- Source
- A zebra-crosslink v17 node run for this explorer. Nothing comes from third-party services.