Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/fuseio/fuse-docs/llms.txt

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

The Balances API provides two endpoints for querying the on-chain token holdings of any wallet address. Use the ERC-20 endpoint to retrieve fungible token and native FUSE balances, and the NFT endpoint to list all ERC-721 and ERC-1155 collectibles owned by an address. Both endpoints are read-only and require only your public API key — no user authentication JWT is needed.

​
Base URL

https://api.fuse.io/api/v0/balances

​
Authentication

Pass your public API key as a query parameter on every request: 
?apiKey=YOUR_PUBLIC_API_KEY
Get your API key from the Fuse Console.

​
Endpoints

​
GET /assets/ — ERC-20 token balances

Returns all ERC-20 fungible token balances (including the native FUSE token) held by the specified wallet address. Endpoint: GET https://api.fuse.io/api/v0/balances/assets/{address}?apiKey={apiKey}

​
Request parameters

​
address
string
required
The wallet address to query for ERC-20 token balances.
​
apiKey
string
required
Your public API key.
​
tokenAddress
string
Optional. Filter results to a specific token contract address. If omitted, all token balances are returned.

​
Response

​
message
string
Status message from the API (e.g., "OK").
​
status
string
Response status string (e.g., "1" for success).
​
result
object[]
Array of fungible token balance objects.

​
Example

curl "https://api.fuse.io/api/v0/balances/assets/0x1234567890abcdef1234567890abcdef12345678?apiKey=YOUR_API_KEY"

{
  "message": "OK",
  "status": "1",
  "result": [
    {
      "balance": "5000000000000000000",
      "contractAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "decimals": "18",
      "name": "Fuse Token",
      "symbol": "FUSE",
      "type": "native"
    },
    {
      "balance": "10000000",
      "contractAddress": "0x620fd5fa44BE6af63715Ef4E65DDFA0387aD13F5",
      "decimals": "6",
      "name": "USD Coin",
      "symbol": "USDC",
      "type": "ERC-20"
    }
  ]
}

​
GET /nft-assets/ — NFT balances

Returns all ERC-721 and ERC-1155 NFT collectibles held by the specified wallet address, with cursor-based pagination. Endpoint: GET https://api.fuse.io/api/v0/balances/nft-assets/{address}?apiKey={apiKey}

​
Request parameters

​
address
string
required
The wallet address to query for NFT holdings.
​
apiKey
string
required
Your public API key.
​
limit
number
default:"100"
Maximum number of NFTs to return. Accepted range: 1–100.
​
cursor
string
Pagination cursor. Use the nextCursor value from a previous response to retrieve the next page of results.

​
Response

​
data
object
Top-level data wrapper.
​
nextCursor
string
Cursor for fetching the next page. null when there are no more results.

​
Example

curl "https://api.fuse.io/api/v0/balances/nft-assets/0x1234567890abcdef1234567890abcdef12345678?apiKey=YOUR_API_KEY&limit=10"

{
  "data": {
    "account": {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "collectibles": [
        {
          "collection": {
            "collectionAddress": "0xb73CC6D7a621E0e220b369C319DBFaC258cEf4D2",
            "collectionName": "FusePunks",
            "collectionSymbol": "PUNK"
          },
          "tokenId": "341",
          "name": "FusePunk #341",
          "description": "A unique FusePunk collectible.",
          "imageURL": "https://ipfs.io/ipfs/Qm.../341.png",
          "descriptorUri": "ipfs://Qm.../341.json",
          "created": "2023-01-15T10:00:00Z"
        }
      ]
    }
  },
  "nextCursor": null
}

​
Error responses

StatusDescription
403Forbidden — invalid or missing apiKey

Build docs developers (and LLMs) love

Get started for freeTalk to us