Skip to main content
GET
Get unspent outputs for address

Authorizations

X-Api-Key
string
header
required

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.

Path Parameters

address
string
required
Required string length: 14 - 128
Pattern: ^[a-zA-HJ-NP-Z0-9]{14,128}$

Query Parameters

network
enum<string>

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.

Available options:
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

Response

400 - */*

from, to, cursor, limit or includeOrdinals was sent. Those moved to GET /api/btc/addresses/{address}/utxos/page; the error body names the parameters received and that route.

txid
string
default:""

Funding txid

vout
integer<int32>
default:""

Output index in the funding tx

value
integer<int64>
default:""

Value in satoshis

status
object

Status (confirmed flag, block height, block hash, block time)

ordinalsIndexed
boolean
default:false

Only with includeOrdinals=true: true when ord's inscription/rune indices have processed this output, so inscriptions/runes below are authoritative (empty list = provably none). false when ord has not examined it (unconfirmed outputs, or ord lagging the chain tip); inscriptions/runes are then omitted, NOT empty.

scriptPubkey
string
default:""

Hex scriptPubKey (only with includeOrdinals=true)

inscriptions
string[]

Inscription IDs on this output (only with includeOrdinals=true; empty list = none)

runes
object[]

Rune balances on this output incl. runeId block:tx (only with includeOrdinals=true; empty list = none)