[
""
]{
"error": "At most 25 credentials per call"
}[
null
][
null
][
null
]Get UTxOs for many payment credentials in one call
Unspent UTxOs for up to 25 payment credentials in a single call, answered from one query instead of one request per credential. Every requested credential 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 cap is 25 rather than the address batch’s 50 because a credential is not one address but every address under it. 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 credential. Split the request into smaller batches when you see it; the field is absent otherwise. Served by cardano-db-sync direct SQL where a db-sync datasource is configured for the network, and by YACI direct SQL elsewhere. Identical response shape and identical row cap either way.
[
""
]{
"error": "At most 25 credentials per call"
}[
null
][
null
][
null
]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 payment-credential lookup request
Payment credential hashes, 56 hex chars each, max 25 per call
25^[0-9a-fA-F]{56}$[
"87be75696aea59b41b36415d0b7c8b7a0c21fe3dd5a63939acfbc3a0"
]
Response
UTxOs per credential
The payment credential exactly as it appeared in the request
"87be75696aea59b41b36415d0b7c8b7a0c21fe3dd5a63939acfbc3a0"
Unspent UTxOs under the credential, newest first. Empty when it 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