Neynar · Example Payload
Get Wallet Balances
Fetch all token balances for a wallet address across multiple networks. Results are paginated.
Onchain
Get Wallet Balances is an example object payload from Neynar, with 9 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields
operationIdmethodpathsummarydescriptiontagsparametersrequestBodyresponses
Example Payload
{
"operationId": "get-wallet-balances",
"method": "GET",
"path": "/v2/onchain/token/balances",
"summary": "Get wallet token balances",
"description": "Fetch all token balances for a wallet address across multiple networks. Results are paginated.",
"tags": [
"Onchain"
],
"parameters": [
{
"name": "networks",
"in": "query",
"required": true,
"description": "Comma-separated list of networks to query. Each value must be a valid network (ethereum, optimism, base, arbitrum).",
"schema": {
"example": "base",
"type": "string",
"x-comma-separated": true
}
},
{
"name": "address",
"in": "query",
"required": true,
"description": "Wallet address",
"schema": {
"example": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"description": "Number of results to return (max 100)",
"schema": {
"default": 50,
"example": 50,
"format": "int32",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
{
"name": "cursor",
"in": "query",
"required": false,
"description": "Pagination cursor.",
"schema": {
"type": "string"
}
}
],
"requestBody": null,
"responses": {
"200": {
"description": "Success",
"schema": {
"properties": {
"balances": {
"items": {
"properties": {
"address": {
"description": "Token contract address",
"example": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"balance": {
"description": "Raw token balance",
"example": "1000000000",
"type": "string"
},
"balance_usd": {
"description": "Balance value in USD",
"example": "1000.50",
"nullable": true,
"type": "string"
},
"decimals": {
"description": "Token decimals",
"example": 6,
"type": "integer"
},
"image_url": {
"description": "Token logo URL",
"example": "https://example.com/token.png",
"nullable": true,
"type": "string"
},
"name": {
"description": "Token name",
"example": "USD Coin",
"type": "string"
},
"network": {
"$ref": "#/components/schemas/Network"
},
"price_usd": {
"description": "Token price in USD",
"example": "1.00",
"nullable": true,
"type": "string"
},
"symbol": {
"description": "Token symbol",
"example": "USDC",
"type": "string"
}
},
"required": [
"network",
"address",
"name",
"symbol",
"decimals",
"balance",
"balance_usd",
"price_usd",
"image_url"
],
"type": "object"
},
"type": "array"
},
"next": {
"properties": {
"cursor": {
"description": "Pagination cursor for next page, null if no more results",
"nullable": true,
"type": "string"
}
},
"required": [
"cursor"
],
"type": "object"
}
},
"required": [
"balances",
"next"
],
"type": "object"
},
"example": null
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/components/schemas/ErrorRes"
},
"example": null
},
"500": {
"description": "Server Error",
"schema": {
"$ref": "#/components/schemas/ErrorRes"
},
"example": null
}
}
}Work with this as data
Every example here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for examples
4 MCP tools reach this
find_examplesBrowse and filter every example in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This example
curl "https://apis.io/api/v1/examples/get-wallet-balances"
All examples
curl "https://apis.io/api/v1/examples?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.