# Fungible ERC20 Token Balances - Batch This API is similar to the previous one for retrieving ERC20 token holdings for a specific address. However, it also supports multiple chains and multiple wallet addresses in a batch format. It provides real-time price information and token details for comprehensive visibility and analysis. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "version": "1.0", "title": "Unmarshal Core APis", "description": "Unmarshal Core APis", "summary": "Unmarshal Core APis", "contact": { "name": "unmarshal", "url": "unmarshal.io", "email": "info@unmarshal.io" }, "license": { "name": "MIT", "url": "https://unmarshal.io" } }, "servers": [ { "url": "https://api.unmarshal.com", "description": "Production url" } ], "security": [ { "auth_key": [] } ], "components": { "securitySchemes": { "auth_key": { "name": "auth_key", "type": "apiKey", "in": "query" } }, "parameters": { "verified": { "name": "verified", "in": "query", "required": false, "schema": { "type": "boolean", "default": false }, "description": "When set to \"true\", it filters out spam tokens and only includes publicly verified tokens and If verified is false, only unverified tokens will be fetched. Leaving it empty fetches all tokens." }, "includeLowVolume": { "name": "includeLowVolume", "in": "query", "required": false, "schema": { "type": "boolean", "default": false }, "description": "It includes price information even for spam and low volume tokens." } } }, "tags": [ { "name": "Balances - ERC20 & NFT", "description": "Balances - ERC20 & NFT" } ], "paths": { "/v3/batch-assets": { "get": { "summary": "Fungible ERC20 Token Balances - Batch", "tags": [ "Balances - ERC20 & NFT" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de": { "type": "object", "properties": { "bsc": { "type": "object", "properties": { "error": { "type": "null" }, "data": { "type": "array", "items": { "type": "object", "properties": { "contract_name": { "type": "string" }, "contract_ticker_symbol": { "type": "string" }, "contract_decimals": { "type": "integer" }, "contract_address": { "type": "string" }, "coin": { "type": "integer" }, "type": { "type": "string" }, "balance": { "type": "string" }, "quote": { "type": "number" }, "quote_rate": { "type": "number" }, "logo_url": { "type": "string" }, "quote_rate_24h": { "type": "string" }, "quote_pct_change_24h": { "type": "number" }, "verified": { "type": "boolean" }, "coin_gecko_id": { "type": "string" } } } } } }, "ethereum": { "type": "object", "properties": { "error": { "type": "null" }, "data": { "type": "array", "items": { "type": "object", "properties": { "contract_name": { "type": "string" }, "contract_ticker_symbol": { "type": "string" }, "contract_decimals": { "type": "integer" }, "contract_address": { "type": "string" }, "coin": { "type": "integer" }, "type": { "type": "string" }, "balance": { "type": "string" }, "quote": { "type": "number" }, "quote_rate": { "type": "number" }, "logo_url": { "type": "string" }, "quote_rate_24h": { "type": "string" }, "quote_pct_change_24h": { "type": "number" }, "verified": { "type": "boolean" }, "coin_gecko_id": { "type": "string" } } } } } } } }, "pujith.eth": { "type": "object", "properties": { "bsc": { "type": "object", "properties": { "error": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "properties": {} } } } }, "ethereum": { "type": "object", "properties": { "error": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "properties": {} } } } } } } }, "x-examples": { "Example": { "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de": { "bsc": { "error": null, "data": [ { "contract_name": "Binance Smart Chain", "contract_ticker_symbol": "BNB", "contract_decimals": 18, "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "coin": 56, "type": "BEP20", "balance": "477978964647601176", "quote": 113.44352746946166, "quote_rate": 237.34, "logo_url": "https://assets.unmarshal.io/tokens/bsc_0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.png", "quote_rate_24h": "2.88", "quote_pct_change_24h": 1.22688, "verified": true, "coin_gecko_id": "binancecoin" } ] }, "ethereum": { "error": null, "data": [ { "contract_name": "Ethereum", "contract_ticker_symbol": "ETH", "contract_decimals": 18, "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "coin": 1, "type": "ERC20", "balance": "563418429638025147", "quote": 940.2833830386038, "quote_rate": 1668.89, "logo_url": "https://assets.unmarshal.io/tokens/ethereum_0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.png", "quote_rate_24h": "34.65", "quote_pct_change_24h": 2.12035, "verified": true, "coin_gecko_id": "ethereum" } ] } }, "pujith.eth": { "bsc": { "error": "invalid address: pujith.eth", "data": [] }, "ethereum": { "error": "invalid address: pujith.eth", "data": [] } } } } }, "examples": { "Example": { "value": { "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de": { "bsc": { "error": null, "data": [ { "contract_name": "Binance Smart Chain", "contract_ticker_symbol": "BNB", "contract_decimals": 18, "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "coin": 56, "type": "BEP20", "balance": "477978964647601176", "quote": 113.44352746946166, "quote_rate": 237.34, "logo_url": "https://assets.unmarshal.io/tokens/bsc_0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.png", "quote_rate_24h": "2.88", "quote_pct_change_24h": 1.22688, "verified": true, "coin_gecko_id": "binancecoin" } ] }, "ethereum": { "error": null, "data": [ { "contract_name": "Ethereum", "contract_ticker_symbol": "ETH", "contract_decimals": 18, "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "coin": 1, "type": "ERC20", "balance": "563418429638025147", "quote": 940.2833830386038, "quote_rate": 1668.89, "logo_url": "https://assets.unmarshal.io/tokens/ethereum_0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.png", "quote_rate_24h": "34.65", "quote_pct_change_24h": 2.12035, "verified": true, "coin_gecko_id": "ethereum" } ] } }, "pujith.eth": { "bsc": { "error": "invalid address: pujith.eth", "data": [] }, "ethereum": { "error": "invalid address: pujith.eth", "data": [] } } } } } } } } }, "operationId": "get-v3-batch-assets", "description": "This API is similar to the previous one for retrieving ERC20 token holdings for a specific address. However, it also supports multiple chains and multiple wallet addresses in a batch format. It provides real-time price information and token details for comprehensive visibility and analysis.", "parameters": [ { "schema": { "type": "string", "default": "demo.eth" }, "in": "query", "name": "wallets", "description": "comma-separated list of wallet addresses", "required": true }, { "schema": { "type": "string" }, "in": "query", "name": "chains", "description": "comma-separated list of chains, set all to fetch balance of all supported chains" }, { "$ref": "#/components/parameters/verified" }, { "$ref": "#/components/parameters/includeLowVolume" } ] } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true }, "_id": "64cccfb6a23a0e001dc86b1e" } ```