[
""
]{
"error": "At most 50 addresses per call"
}{
"error": "Not Implemented"
}Get UTxOs for many Cardano addresses in one call
Unspent UTxOs for up to 50 addresses in a single call, answered from one yaci-store query instead of one request per address. Every requested address appears in the response, in request order, with an empty utxos array when it holds nothing, so the response can be zipped against the request. The 50-address cap is a load guard: a single hot address can hold tens of thousands of lifetime outputs, so an uncapped batch would let one call saturate the backend. The response is also row-capped (5000 UTxOs across the whole batch by default). If the cap is hit, EVERY entry carries “truncated”: true and the response is incomplete - including entries that came back empty, because the rows are ordered newest-first across the batch rather than per address. Split the request into smaller batches when you see it; the field is absent otherwise. Served by YACI direct SQL with no provider fallback.
[
""
]{
"error": "At most 50 addresses per call"
}{
"error": "Not Implemented"
}Authorizations
API key (programmatic access — recommended)
Send your API key in the X-Api-Key header. Keys start with nxs_ and are
created in the dashboard (or via POST /api/keys with a session JWT).
Each key is scoped to one chain and one network (for example
CARDANO_MAINNET), fixed at creation time. It cannot query a different network
on the same chain, and it cannot query a different chain at all. A mismatched
network parameter returns 400 Network Mismatch. Create one key per chain
and network under the same account.
This is the credential most integrations should use.
Query Parameters
Accepts either the value listed here (CARDANO_MAINNET) or its kebab-case alias (cardano-mainnet); matching is case-insensitive. Omit it and the network is taken from the API key. A value that disagrees with the key's own network returns 400 Network Mismatch.
CARDANO_MAINNET, CARDANO_PREPROD, CARDANO_PREVIEW, APEX_PRIME_MAINNET, APEX_VECTOR_MAINNET, APEX_VECTOR_TESTNET, MIDNIGHT_MAINNET, MIDNIGHT_PREPROD, MIDNIGHT_STAGENET, BITCOIN_MAINNET, BITCOIN_TESTNET4 Body
Bulk address UTxO lookup request
Cardano addresses, max 50 per call
50^[a-zA-Z0-9]{10,150}$[
"addr1qxy8p07tr8k3x5nc4sr77gvkcs7g54rd0dtwjyeuc4x0dhqxq6xg4d6dxr5x5qa6a3g2p6a0f7yq5j6l9k2z0t7lqvsqk8j0z"
]
Response
UTxOs per address
The address exactly as it appeared in the request
"addr1qxy8p07tr8k3x5nc4sr77gvkcs7g54rd0dtwjyeuc4x0dhqxq6xg4d6dxr5x5qa6a3g2p6a0f7yq5j6l9k2z0t7lqvsqk8j0z"
Unspent UTxOs at the address, newest first. Empty when the address holds none.
Show child attributes
Show child attributes
Present and true only when the batch exceeded the server's row cap. The whole response is then incomplete, including entries that look empty: split the request into smaller batches.
true