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 endpoints to query token and NFT balances for any wallet address on Fuse Network. Use the ERC20 endpoint to fetch fungible token holdings including the native FUSE token, and the NFT endpoint to retrieve ERC-721 and ERC-1155 collectibles with metadata. All requests are authenticated with your public API key.

​
Base URL

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

​
Authentication

All requests require a public API key passed as a query parameter: 
?apiKey=YOUR_PUBLIC_API_KEY
Get your API key from the Fuse Console.

​
GET /assets/

Returns all ERC20 fungible token balances for a wallet address, including the native FUSE token.

​
Request parameters

​
apiKey
string
required
Your public API key.
​
address
string
required
The wallet address to query for ERC20 token balances.
​
tokenAddress
string
Optional. A specific ERC20 token contract address. If provided, only the balance for that token is returned. If omitted, all token balances are returned.

​
Response

​
data
object
Response data wrapper.
​
data.account
object
Account information and token holdings.
​
data.account.address
string
The queried wallet address.
​
data.account.tokens
array
Array of token balance objects.
​
data.account.tokens[].tokenAddress
string
The ERC20 token contract address. For the native FUSE token, this is 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.
​
data.account.tokens[].name
string
Token name (e.g., Fuse).
​
data.account.tokens[].symbol
string
Token symbol (e.g., FUSE).
​
data.account.tokens[].decimals
integer
Number of decimal places for the token.
​
data.account.tokens[].balance
string
Token balance in base units (before applying decimals).

​
Example

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

{
  "data": {
    "account": {
      "address": "0xYourWalletAddress",
      "tokens": [
        {
          "tokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
          "name": "Fuse",
          "symbol": "FUSE",
          "decimals": 18,
          "balance": "5000000000000000000"
        }
      ]
    }
  }
}

​
GET /nft-assets/

Returns all ERC-721 and ERC-1155 NFT assets owned by a wallet address.

​
Request parameters

​
apiKey
string
required
Your public API key.
​
address
string
required
The wallet address to query for NFT assets.
​
limit
integer
default:"100"
Maximum number of NFTs to return per request. Minimum: 1, maximum: 100.
​
cursor
string
Pagination cursor. Use the nextCursor value from the previous response to fetch the next page of results.

​
Response

​
data
object
Response data wrapper.
​
data.account
object
Account information and NFT holdings.
​
data.account.address
string
The queried wallet address.
​
data.account.collectibles
array
Array of NFT collectible objects.
​
data.account.collectibles[].id
string
Unique identifier for the NFT.
​
data.account.collectibles[].tokenId
string
The NFT token ID within its collection.
​
data.account.collectibles[].name
string
Display name of the NFT.
​
data.account.collectibles[].description
string
Description of the NFT.
​
data.account.collectibles[].imageURL
string
URL of the NFT’s image or media.
​
data.account.collectibles[].descriptorUri
string
Metadata URI (e.g., IPFS or HTTP URL) for the NFT.
​
data.account.collectibles[].created
string
Timestamp when the NFT was minted.
​
data.account.collectibles[].collection
object
Information about the NFT’s parent collection.
​
data.account.collectibles[].collection.collectionAddress
string
Contract address of the collection.
​
data.account.collectibles[].collection.collectionName
string
Name of the collection.
​
data.account.collectibles[].collection.collectionSymbol
string
Symbol of the collection.
​
data.account.collectibles[].owner
object
Current owner of the NFT.
​
data.account.collectibles[].owner.id
string
Owner’s wallet address.
​
data.account.collectibles[].creator
object
Original creator of the NFT.
​
data.account.collectibles[].creator.id
string
Creator’s wallet address.
​
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/0xYourWalletAddress?apiKey=YOUR_API_KEY&limit=10"

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

​
Error responses

​
statusCode
integer
HTTP status code of the error.
​
errorMessage
string
Human-readable error description.
​
error
string
Short error code.
StatusMeaning
403Forbidden — invalid or missing API key

Build docs developers (and LLMs) love

Get started for freeTalk to us