Skip to main content
GET
/
api
/
v1
/
balances
/
{address}
Get address balances
curl --request GET \
  --url https://api.example.com/api/v1/balances/{address}
{
  "code": 0,
  "msg": "ok",
  "data": {
    "address": "0xabc1230000000000000000000000000000000000",
    "updatedAt": "2026-05-11T10:00:00.000Z",
    "chains": [
      {
        "chainId": 8453,
        "name": "Base",
        "isTestnet": false
      }
    ],
    "balances": [
      {
        "chainId": 8453,
        "tokenAddress": "native",
        "symbol": "ETH",
        "name": "ETH",
        "decimals": 18,
        "balance": "1000000000000000000",
        "formattedBalance": "1",
        "isNative": true
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.nexfi.robert.dpdns.org/llms.txt

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

Path Parameters

address
string
required

Wallet address.

Example:

"0xabc1230000000000000000000000000000000000"

Query Parameters

chainIds
string

Chain filter, comma separated.

Example:

"8453,1"

includeTokens
enum<string>

Whether token balances should be included.

Available options:
true,
false
Example:

"true"

includeNative
enum<string>

Whether native-token balances should be included.

Available options:
true,
false
Example:

"true"

Response

200 - application/json

Balance response

Standard response envelope.

code
integer
required

Business status code. 0 means success.

Example:

0

msg
string
required

Human-readable message.

Example:

"ok"

data
object