Skip To Content

Blockdaemon Documentation

Accounts

Overview
GET Balances of Address (V1)
GET Transactions of Address (V1)
POST Balances of Addresses (V1)
GET Balances of Address (V2)
GET Transactions of Address (V2)
POST Balances of Addresses (V2)

Overview

The Ubiquity Universal API endpoints listed in this section allow the retrieval of balances, transactions, and other details of accounts (identified by addresses) for a given protocol and network.

You can use the Universal API Accounts endpoints to access both native coin and token information.

As with all Ubiquity Universal API endpoints, they provide a standard format to obtain consistent information across multiple protocols.

GET Balances of Address (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/account/{address}

Returns the native and token balances of a given account.

Developer documentation: GET Balances of Address (V1)
Learn how to authorize your request: Authentication Guide

Note: For Ethereum this endpoint returns only ETH balances by default. To get token balances, add query parameters (see below).

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also required to specify an account address as the last path parameter, e.g.:

  • 0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b

Query Parameters

To query particular assets, use the following parameter:

  • parameter: assets
  • value: an asset path or a comma-separated list of paths

You can specify a token or a native coin, e.g.:

  • LINK
    ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20
  • MATIC
    ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20
  • ETH (native)
    ethereum/native/eth

See also: Available Currencies and Tokens

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet		bitcoin/mainnet
bitcoin/testnet
Bitcoin CashMainnet
Testnet		bitcoincash/mainnet
bitcoincash/testnet
EthereumMainnet
Ropsten		ethereum/mainnet
ethereum/ropsten
LitecoinMainnet
Testnet		litecoin/mainnet
litecoin/testnet
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
SolanaMainnetsolana/mainnet
StellarMainnetstellar/mainnet
TerraMainnet
Testnet		terra/mainnet
terra/testnet
TezosMainnettezos/mainnet
XRPMainnetxrp/mainnet

Example Queries

The following queries provide useful examples for GET Balances of Address (V1).

To get the balance of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/account/0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b

To get the LINK balance of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/account/0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20

To get the LINK, MATIC and native ETH balances of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/account/0x6DAb591a596d2714390bCe1E7B9bAfF5e531b72C?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20,ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20,ethereum/native/eth

GET Transactions of Address (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/account/{address}/txs

Returns all native coin and token transactions that a given account was involved with, starting with the latest one.

Developer documentation: GET Transactions of Address (V2)
Learn how to authorize your request: Authentication Guide

Note: You will get all transactions where the given wallet was sender or receiver. See the source and destination fields of the response.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • stellar/mainnet

It is also required to add an account address, e.g.:

  • GCTLKGBKLQVVHQMPI3WYNHQUSRFUDV3JS455OX62XBAYYM22EDTYYF3F

Query Parameters

To query particular assets, use the following parameter:

  • parameter: assets
  • value: an asset path or a comma-separated list of paths

You can specify a token, or a native coin, e.g.:

  • XLM (native)
    stellar/native/xlm
  • AQUA
    stellar/credit_alphanum4/aqua
  • BTCLN
    stellar/credit_alphanum12/btcln

See also: Available Currencies and Tokens

To set the sort order, use:

  • parameter: order
  • value: asc / desc

To set the maximum number of transactions returned on one page, use:

  • parameter: limit
  • value: 25 by default, up to 100

To get the next page, use:

  • parameter: continuation
  • value: returned in the continuation field

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet		bitcoin/mainnet
bitcoin/testnet
Bitcoin CashMainnet
Testnet		bitcoincash/mainnet
bitcoincash/testnet
LitecoinMainnet
Testnet		litecoin/mainnet
litecoin/testnet
StellarMainnetstellar/mainnet
TezosMainnettezos/mainnet
XRPMainnetxrp/mainnet

Example Queries

The following queries provide useful examples for GET Transactions of Address (V1).

To get all transactions of a given Stellar Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v1/stellar/mainnet/account/GCTLKGBKLQVVHQMPI3WYNHQUSRFUDV3JS455OX62XBAYYM22EDTYYF3F/txs

To get AQUA transactions of a given Stellar Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v1/stellar/mainnet/account/GCTLKGBKLQVVHQMPI3WYNHQUSRFUDV3JS455OX62XBAYYM22EDTYYF3F/txs?assets=stellar/credit_alphanum4/aqua

To get AQUA and BTCLN transactions of a given Stellar Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v1/stellar/mainnet/account/GCTLKGBKLQVVHQMPI3WYNHQUSRFUDV3JS455OX62XBAYYM22EDTYYF3F/txs?assets=stellar/credit_alphanum4/aqua,stellar/credit_alphanum12/btcln

POST Balances of Addresses (V1)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/accounts

Returns the native and token balances of multiple given accounts.

Developer documentation: POST Balances of Addresses (V1)
Learn how to authorize your request: Authentication Guide

Note: For Ethereum this endpoint returns only ETH balances by default. To get token balances, add query parameters (see below).

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Request Body

In the body of your request, specify an array of account addresses to query, for example:


{
    "addresses": [
        "0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b",
        "0xdc7D545a03307c89Eb4A22953183c961Ccfa398E",
        "0xB2DC5571f477b1C5b36509a71013BFedD9Cc492F",
        "0x12274c71304bC0E6B38a56b94D2949B118feb838",
        "0xf27153d7475dBFBF82580cE2f5Bad1C47b1AF0e8"
    ]
}

Query Parameters

To query particular assets, use the following parameter:

  • parameter: assets
  • value: an asset path or a comma-separated list of paths

You can specify a token or a native coin, e.g.:

  • LINK
    ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20
  • MATIC
    ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20
  • ETH (native)
    ethereum/native/eth

See also: Available Currencies and Tokens

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnet
Testnet		bitcoin/mainnet
bitcoin/testnet
Bitcoin CashMainnet
Testnet		bitcoincash/mainnet
bitcoincash/testnet
EthereumMainnet
Ropsten		ethereum/mainnet
ethereum/ropsten
LitecoinMainnet
Testnet		litecoin/mainnet
litecoin/testnet
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
SolanaMainnetsolana/mainnet
StellarMainnetstellar/mainnet
TerraMainnetterra/mainnet
TezosMainnettezos/mainnet
XRPMainnetxrp/mainnet

Example Queries

The following queries provide useful examples for POST Balances of Addresses (V1).

To get balances of given Ethereum Mainnet wallets, use the following query:

https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/accounts

To get LINK balances of given Ethereum Mainnet wallets, use the following:

https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/accounts?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20

To get LINK, MATIC, and native ETH balances of given Ethereum Mainnet wallets, use the following:

https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/accounts?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20,ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20,ethereum/native/eth

GET Balances of Address (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/account/{address}

Returns the native and token balances of a given account.

Developer documentation: GET Balances of Address (V2)
Learn how to authorize your request: Authentication Guide

Note: For Ethereum this endpoint returns only ETH balances by default. To get token balances, add query parameters (see below).

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also required to specify an account address as the last path parameter, e.g.:

  • 0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b

Query Parameters

To query particular assets, use the following parameter:

  • parameter: assets
  • value: an asset path or a comma-separated list of paths

You can specify a token or a native coin, e.g.:

  • LINK
    ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20
  • MATIC
    ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20
  • ETH (native)
    ethereum/native/eth

See also: Available Currencies and Tokens

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnetbitcoin/mainnet
DiemMainnetdiem/mainnet
EthereumMainnet
Ropsten		ethereum/mainnet
ethereum/ropsten
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
StellarMainnetstellar/mainnet
XRPMainnetxrp/mainnet

Example Queries

The following queries provide useful examples for GET Balances of Address (V2).

To get the balance of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/account/0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b

To get the LINK balance of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/account/0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20

To get the LINK, MATIC and native ETH balances of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/account/0x6DAb591a596d2714390bCe1E7B9bAfF5e531b72C?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20,ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20,ethereum/native/eth

GET Transactions of Address (V2)

https://ubiquity.api.blockdaemon.com/v2/{protocol}/{network}/account/{address}/txs

Returns all native coin and token transactions that a given account was involved with, starting with the latest one.

Developer documentation: GET Transactions of Address (V2)
Learn how to authorize your request: Authentication Guide

Note: You will get all transactions where the given wallet was sender or receiver. See the from and to fields of the response.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also required to specify an account address, e.g.:

  • 0xdc7D545a03307c89Eb4A22953183c961Ccfa398E

Query Parameters

To query particular assets, use the following parameter:

  • parameter: assets
  • value: an asset path or a comma-separated list of paths

You can specify a token or a native coin, e.g.:

  • LINK
    ethereum/contract/0x514910771af9ca656af840dff83e8264ecf986ca/erc-20
  • MATIC
    ethereum/contract/0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0/erc-20
  • ETH (native)
    ethereum/native/eth

See also: Available Currencies and Tokens

To set the sort order, use:

  • parameter: order
  • value: asc / desc

To set the maximum number of transactions returned on one page, use:

  • parameter: limit
  • value: 25 by default, up to 100

To get the next page, use:

  • parameter: continuation
  • value: returned in the continuation field

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnetbitcoin/mainnet
DiemMainnetdiem/mainnet
EthereumMainnetethereum/mainnet
PolkadotMainnetpolkadot/mainnet
StellarMainnetstellar/mainnet
XRPMainnetxrp/mainnet

Example Queries

The following queries provide useful examples for GET Transactions of Address (V2).

To get all transactions of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/account/0xF7829581DC8250eF2ef1952064FBf45674B888D2/txs

To get LINK transactions of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/account/0xdc7D545a03307c89Eb4A22953183c961Ccfa398E/txs?assets=ethereum/contract/0x514910771af9ca656af840dff83e8264ecf986ca/erc-20

To get LINK and MATIC transactions of a given Ethereum Mainnet wallet, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/account/0xdc7D545a03307c89Eb4A22953183c961Ccfa398E/txs?assets=ethereum/contract/0x514910771af9ca656af840dff83e8264ecf986ca/erc-20,ethereum/contract/0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0/erc-20

POST Balances of Addresses (V2)

https://ubiquity.api.blockdaemon.com/v1/{protocol}/{network}/accounts

Returns the native and token balances of multiple given accounts.

Developer documentation: POST Balances of Addresses (V2)
Learn how to authorize your request: Authentication Guide

Note: For Ethereum this endpoint returns only ETH balances by default. To get token balances, add query parameters (see below).

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Request Body

In the body of your request, specify an array of account addresses to query, for example:


{
    "addresses": [
        "0x6E4ab39231b7549735C4D584d9CbBb3CB6Ed4f1b",
        "0xdc7D545a03307c89Eb4A22953183c961Ccfa398E",
        "0xB2DC5571f477b1C5b36509a71013BFedD9Cc492F",
        "0x12274c71304bC0E6B38a56b94D2949B118feb838",
        "0xf27153d7475dBFBF82580cE2f5Bad1C47b1AF0e8"
    ]
}

Query Parameters

To query particular assets, use the following parameter:

  • parameter: assets
  • value: an asset path or a comma-separated list of paths

You can specify a token or a native coin, e.g.:

  • LINK
    ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20
  • MATIC
    ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20
  • ETH (native)
    ethereum/native/eth

See also: Available Currencies and Tokens

Supported Protocols and Networks

Here is a full list of supported protocols and networks with their path parameters:

ProtocolNetworkPath parameters
AlgorandMainnetalgorand/mainnet
BitcoinMainnetbitcoin/mainnet
DiemMainnetdiem/mainnet
EthereumMainnet
Ropsten		ethereum/mainnet
ethereum/ropsten
NEARMainnetnear/mainnet
OasisMainnetoasis/mainnet
PolkadotMainnetpolkadot/mainnet
StellarMainnetstellar/mainnet
XRPMainnetxrp/mainnet

Example Queries

The following queries provide useful examples for POST Balances of Addresses (V2).

To get balances of given Ethereum Mainnet wallets, use the following query:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/accounts

To get LINK balances of given Ethereum Mainnet wallets, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/accounts?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20

To get LINK, MATIC, and native ETH balances of given Ethereum Mainnet wallets, use the following:

https://ubiquity.api.blockdaemon.com/v2/ethereum/mainnet/accounts?assets=ethereum/contract/0x514910771AF9Ca656af840dff83E8264EcF986CA/erc-20,ethereum/contract/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0/erc-20,ethereum/native/eth

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.