Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nexus.gerowallet.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Addresses API provides endpoints for querying address information on the Cardano blockchain. You can retrieve balances, UTXOs, and transaction history for any Cardano address.

​
Available endpoints

Get address info

Retrieve balance and associated stake address

Get address UTXOs

List all unspent outputs for an address

Get UTXOs by asset

Filter address UTXOs containing a specific asset

Get address transactions

Get transaction history for an address

​
Address formats

Gero Nexus supports all Cardano address formats:
FormatExample prefixDescription
Bech32addr1...Standard mainnet payment address
Bech32 (testnet)addr_test1...Testnet payment address
ByronAe2..., DdzF...Legacy Byron-era address
Stakestake1...Stake/reward address

​
Address information

The address info endpoint returns:
  • address - The queried address
  • balance - Total ADA balance in lovelace
  • stake_address - Associated stake address (if any)
  • script - Whether this is a script address
  • amount - Array of assets held at this address
{
  "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3jcu5d8ps7zex2k2xt3uqxgjqnnj83ws8lhrn648jjxtwq2ytjqp",
  "balance": "1234567890",
  "stake_address": "stake1uxxx...",
  "script": false,
  "amount": [
    {
      "unit": "lovelace",
      "quantity": "1234567890"
    },
    {
      "unit": "policyid.assetname",
      "quantity": "100"
    }
  ]
}

​
UTXOs

Unspent Transaction Outputs (UTXOs) represent the spendable funds at an address. Each UTXO includes:
  • tx_hash - Transaction hash that created this UTXO
  • output_index - Output index within the transaction
  • amount - Array of assets in this UTXO
  • block - Block hash where the UTXO was created
  • data_hash - Datum hash (for smart contract UTXOs)
  • inline_datum - Inline datum value (if present)
  • reference_script_hash - Reference script hash (if present)

​
Pagination

The UTXOs and transactions endpoints support pagination:
ParameterDefaultMaxDescription
page11000Page number (1-based)
pageSize100100Items per page

​
Example: Check address balance

curl -X GET "https://nexus-dev.gerowallet.io/api/addresses/addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3jcu5d8ps7zex2k2xt3uqxgjqnnj83ws8lhrn648jjxtwq2ytjqp?network=MAINNET" \
  -H "Authorization: Bearer your-token"