DOCS/GRAPHQL/ADDRESSES

Addresses & UTXOs

Query address balances, UTXOs, and transaction history for any Verus address.

Get Address Balances

Fetch all currency balances for an address:

query {
  addressBalances(
    chainId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
    address: "RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA"
  ) {
    address
    balances {
      currencyId
      currencyName
      balance
      totalReceived
      totalSent
      utxoCount
    }
  }
}

Get Single Currency Balance

query {
  addressBalance(
    chainId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
    address: "RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA"
    currencyId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
  ) {
    balance
    totalReceived
    totalSent
    utxoCount
  }
}

Get UTXOs

Fetch unspent transaction outputs:

query {
  addressUTXOs(
    chainId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
    address: "RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA"
    onlyUnspent: true
  ) {
    utxos {
      txid
      voutIndex
      amount
      currencyId
      blockHeight
      confirmations
    }
    totalCount
  }
}

Address Transactions

query {
  addressTransactions(
    chainId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
    address: "RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA"
    limit: 20
  ) {
    transactions {
      txid
      blockHeight
      timestamp
      isInput
      isOutput
      netChange
    }
    totalCount
    hasMore
  }
}

Rich List

Get top holders for a currency:

query {
  richList(
    chainId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
    currencyId: "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq"
    limit: 100
  ) {
    entries {
      rank
      address
      balance
      percentage
    }
    totalHolders
    totalSupply
  }
}

Types

type AddressBalance {
  currencyId: String!
  currencyName: String
  balance: Decimal!
  totalReceived: Decimal!
  totalSent: Decimal!
  utxoCount: Int!
}

type UTXO {
  txid: String!
  voutIndex: Int!
  address: String!
  amount: Decimal!
  currencyId: String!
  blockHeight: BigInt!
  confirmations: Int
  isSpent: Boolean!
  isCoinbase: Boolean!
}

type AddressTransaction {
  txid: String!
  blockHeight: BigInt!
  timestamp: DateTime
  isInput: Boolean!
  isOutput: Boolean!
  netChange: JSON!
}