Skip to main content
GET
/
v2
/
{chain_name}
/
wallets
/
{wallet_address}
/
balances
Get Wallet Balances
curl --request GET \
  --url https://api.data.ormilabs.com/v2/{chain_name}/wallets/{wallet_address}/balances \
  --header 'Authorization: Bearer <token>'
{
  "balances": [
    {
      "balance": 123123.1321321,
      "balance_raw": "1231231321321",
      "token": {
        "address": "0x312e67b47a2a29ae200184949093d92369f80b53",
        "decimals": 7,
        "name": "Bacacacac",
        "standard": "ERC-20",
        "symbol": "BAC"
      }
    }
  ],
  "next_cursor": "ICJkYXNkYXMifQ=="
}

Authorizations

​
Authorization
string
header
required

Enter your API key in the format: Bearer <api_key>. Providing an API key may grant higher rate limits or access to additional features. The API will function without an API key for basic access.

Path Parameters

​
wallet_address
string
required

The wallet address.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

​
chain_name
enum<string>
required

The name or ID of the blockchain.

Available options:
ethereum,
apechain,
arbitrum,
avalanche,
base,
bsc,
polygon
Example:

"ethereum"

Query Parameters

​
token_address
string

Token contract addresses to filter by.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"

​
token_standard
enum<string>
default:ERC-20

Token standard to filter by.

Available options:
ERC-20,
ERC-721,
ERC-1155,
NATIVE,
ALL
​
block_number
integer<int64>

Retrieve data at a specific block number.

Example:

18000000

​
timestamp
string<date-time>

Retrieve data at a specific timestamp (Unix or ISO 8601 string).

Example:

"2024-05-20T12:00:00Z"

​
sort_by
enum<string>
default:most_holdings

Sort order for results.

Available options:
most_holdings,
least_holdings
​
limit
integer
default:50

Maximum number of items to return.

Required range: 1 <= x <= 1000
​
cursor
string

Cursor for pagination to retrieve the next set of results.

Response

Successfully retrieved wallet balances.

​
balances
object[]
required
​
next_cursor
string
Example:

"ICJkYXNkYXMifQ=="