跳转到主要内容
GET
/
api
/
v1
/
balances
/
{address}
获取地址余额
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.

路径参数

address
string
必填

钱包地址。

示例:

"0xabc1230000000000000000000000000000000000"

查询参数

chainIds
string

链过滤,逗号分隔。

示例:

"8453,1"

includeTokens
enum<string>

是否包含代币余额。

可用选项:
true,
false
示例:

"true"

includeNative
enum<string>

是否包含原生币余额。

可用选项:
true,
false
示例:

"true"

响应

200 - application/json

成功返回余额结果

统一响应包裹结构。

code
integer
必填

业务状态码,0 表示成功。

示例:

0

msg
string
必填

可读返回消息。

示例:

"ok"

data
object