CurrencyIncrementalSnapshot objects, which are then submitted to the Global L0 for inclusion in global snapshots.
All endpoints return the following response headers:
- X-Id — The node’s public key identifier
- X-Session-Token — The current cluster session token
- Request-Signature — Cryptographic signature of the response for verification
Base URL
The Currency L0 API typically runs on port9200 (metagraph nodes may use different ports depending on deployment configuration).
Cluster Endpoints
The cluster endpoints behave identically to the Global L0 cluster API but return peers in the metagraph’s own L0 cluster.GET /cluster/info
Returns a list of peers in the metagraph L0 cluster.GET /cluster/info.
GET /cluster/session
Returns the current cluster session token for the metagraph L0 cluster.Snapshot Endpoints
The currency L0 snapshot endpoints mirror the Global L0 snapshot endpoints but returnCurrencyIncrementalSnapshot objects instead of GlobalIncrementalSnapshot.
GET /snapshots/latest/ordinal
Returns the ordinal of the latest metagraph snapshot.200 OK
The ordinal number of the latest currency snapshot
404 Not Found — No snapshot available yet.
Response 503 Service Unavailable — Node not ready.
GET /snapshots/latest
Returns the full latest currency snapshot, signed by the metagraph facilitators. Supports both JSON and binary (application/octet-stream) response formats.
200 OK — Returns a SignedCurrencyIncrementalSnapshot.
The currency snapshot data
Cryptographic proofs from metagraph facilitator nodes
GET /snapshots/latest/combined
Returns the latest currency snapshot combined with its full computed state.200 OK — Returns a SignedCurrencyIncrementalSnapshotCombined (snapshot + state pair).
GET /snapshots/
Returns a specific currency snapshot by ordinal.The snapshot ordinal to retrieve
Currency Token Endpoints
The currency L0 node exposes token supply and balance endpoints for the metagraph’s native token.GET /currency/total-supply
Returns the total supply of the metagraph’s native currency token.200 OK
Total token supply in the smallest unit
Snapshot ordinal at which this supply was calculated
GET /currency//balance
Returns the currency token balance for a given wallet address.The wallet address to query
200 OK
Token balance in the smallest unit
Snapshot ordinal at which this balance was recorded
Transaction Error Lookup
GET /transactions//errors
Returns validation errors for a transaction that was rejected during metagraph processing. This endpoint is unique to the Currency L0 API.Transaction hash to look up validation errors for
200 OK
Human-readable description of the validation error
404 Not Found — No error record found for this transaction hash.
Response 503 Service Unavailable — Node not ready.
Metrics
GET /metrics
Returns Micrometer Prometheus metrics for the currency L0 node.GET /metrics.
Key Differences from Global L0
| Feature | Global L0 | Currency L0 |
|---|---|---|
| Snapshot type | GlobalIncrementalSnapshot | CurrencyIncrementalSnapshot |
| Snapshot path prefix | /global-snapshots | /snapshots |
| Token endpoints | /dag/... | /currency/... |
| State channel snapshots | Yes (from all metagraphs) | No |
| Custom data field | No | Yes (data byte array) |
| Delegated stakes | Yes | No |
| Node collateral | Yes | No |
| Transaction errors endpoint | No | Yes (/transactions/{hash}/errors) |