{"uid":"cap_I7XGcRBlX-2Ypvs1KiF65","slug":"api-nansen-ai-575979f8","name":"Nansen Address Current Balance","description":"Get Address Current Balance Data","url":"https://api.nansen.ai/api/v1/profiler/address/current-balance","method":"GET","headers":{},"bodySchema":{"type":"object","title":"ProfilerAddressBalancesRequest","examples":[{"chain":"ethereum","address":"0x28c6c06298d514db089934071355e5743bf21d60","pagination":{"page":1,"per_page":10},"hide_spam_token":true},{"chain":"ethereum","pagination":{"page":1,"per_page":10},"entity_name":"Vitalik Buterin","hide_spam_token":true}],"required":["chain"],"properties":{"chain":{"enum":["all","arbitrum","avalanche","base","bitcoin","bnb","ethereum","hyperevm","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","ronin","scroll","sei","solana","sonic","starknet","sui","ton","tron"],"type":"string","title":"ProfilerChain","description":"Chains supported in profiler analysis."},"address":{"anyOf":[{"type":"string"}],"title":"Address","examples":["0x28c6c06298d514db089934071355e5743bf21d60","8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"],"description":"Address to get balances for"},"filters":{"anyOf":[{"type":"object","title":"ProfilerAddressBalancesFilters","properties":{"price_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"max":1000,"min":0.01}],"description":"Token price range filter in USD"},"value_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"max":100000,"min":10}],"description":"Balance range filter in USD"},"token_name":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Name","examples":["USD Coin","%Ethereum%"],"description":"Token name filter"},"token_amount":{"anyOf":[{"type":"object","title":"IntegerRangeFilter","properties":{"max":{"anyOf":[{"type":"integer"}],"title":"Max","examples":[100,1000,10000],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"integer"}],"title":"Min","examples":[10,100,1000],"description":"Minimum value (inclusive)"}},"description":"Filter for integer values with optional min/max bounds.\nUse for counts, numbers of items, and other whole number values. - Values between 5 and 100"}],"examples":[{"max":1000000,"min":1}],"description":"Token amount range filter"},"token_symbol":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Symbol","examples":["USDC","%ETH%"],"description":"Token symbol filter"},"token_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Address","examples":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"description":"Token address filter"}},"description":"Filters for profiler address current balance endpoint.\n\nThese filters control which token balances are included.","additionalProperties":false}],"examples":[{"value_usd":{"min":10},"token_symbol":"USDC"}],"description":"Additional filters to apply. Only filters for columns that are being selected will be applied."},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SortOrder[ProfilerAddressBalancesSortField]","required":["field","direction"],"properties":{"field":{"enum":["value_usd","token_symbol"],"type":"string","title":"ProfilerAddressBalancesSortField","description":"Enum for sortable fields in profiler address balances."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","description":"Custom sort order to override the endpoint's default ordering"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."},"entity_name":{"anyOf":[{"type":"string"}],"title":"Entity Name","examples":["Vitalik Buterin","Binance"],"description":"Entity name to get balances for"},"hide_spam_token":{"type":"boolean","title":"Hide Spam Token","default":true,"examples":[true],"description":"Removes suspicious tokens from the balance list"}},"description":"","additionalProperties":false},"responseSchema":{"type":"object","title":"ProfilerAddressBalancesResponse","required":["pagination","data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"ProfilerBalance","required":["chain","address","token_address","token_symbol"],"properties":{"chain":{"type":"string","title":"Chain","description":"Chain"},"address":{"type":"string","title":"Address","description":"Address of the wallet. Empty if entity_name is provided. EVM addresses are returned in lowercase."},"price_usd":{"anyOf":[{"type":"number"}],"title":"Price Usd","description":"Price of the token"},"value_usd":{"anyOf":[{"type":"number"}],"title":"Value Usd","description":"Token balance value in USD"},"token_name":{"anyOf":[{"type":"string"}],"title":"Token Name","description":"Token name"},"token_amount":{"anyOf":[{"type":"number"}],"title":"Token Amount","description":"Token balance"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"token_address":{"type":"string","title":"Token Address","description":"Address of token"}},"description":"Individual profiler balance record.\n\nRepresents a single token balance from the wallet profiler."},"title":"Data","description":"List of balance records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response model for profiler address current-balance endpoint.\n\nContains the filtered balance data with metadata."},"example":{"request":{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890"},"response":{"data":[{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":1905.1132976132947,"value_usd":33097.81352494653,"token_name":"Ethereum","token_amount":17.373147080759505,"token_symbol":"ETH","token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":0.9985699475169804,"value_usd":887.1366951291893,"token_name":"Tether USD","token_amount":888.407164,"token_symbol":"USDT","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":6.796674114293142,"value_usd":8.8701539053274,"token_name":"GateChainToken","token_amount":1.30507271,"token_symbol":"GT","token_address":"0xe66747a101bff2dba3697199dcce5b743b454759"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":67658.30663865499,"value_usd":8.390306606259605,"token_name":"Wrapped BTC","token_amount":0.00012401,"token_symbol":"WBTC","token_address":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":1.03067840670188,"value_usd":5.546741181628296,"token_name":"Reputation (Augur)","token_amount":5.38164101,"token_symbol":"REP","token_address":"0x1985365e9f78359a9b6ad760e32412f4a445e862"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":1.9879517150640604,"value_usd":4.285080552434621,"token_name":"Livepeer Token","token_amount":2.1555254687343033,"token_symbol":"LPT","token_address":"0x58b6a8a3302369daec383334672404ee733ab239"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":1.0000606183860823,"value_usd":1.0000606183860823,"token_name":"PayPal PYUSD","token_amount":1,"token_symbol":"PYUSD","token_address":"0x6c3ea9036406852006290770bedfcaba0e23a0e8"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":0.9997647001083332,"value_usd":0.614025485865535,"token_name":"USD Coin","token_amount":0.61417,"token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":0.9997034399811773,"value_usd":0.5442829839897522,"token_name":"DAI","token_amount":0.5444444444444445,"token_symbol":"DAI","token_address":"0x6b175474e89094c44da98b954eedeac495271d0f"},{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890","price_usd":0.003055332900389362,"value_usd":0.3832694046371515,"token_name":"Republic Token","token_amount":125.44276422,"token_symbol":"REN","token_address":"0x408e41876cccdc0f92210600ef50372656052a38"}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"chain":"ethereum","address":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B2QsxYVBOqaxUh6I2lblj","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_k34cblSObuYy6P2NiWakp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current token and native coin balance data for a given blockchain address using Nansen's wallet intelligence platform.","exampleAgentPrompt":"What tokens and coins does wallet 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE currently hold? Pull the current balance data from Nansen.","exampleUseCases":null,"resultDescription":"Returns a snapshot of all current token and native coin balances held by the queried address, including token names, symbols, amounts, and likely USD values — powered by Nansen's wallet labeling and smart money analytics.","failureModes":["Invalid or malformed address returns 400 error","Address not found or never active on supported chains returns empty result","Unsupported blockchain network returns error","Rate limit exceeded returns 429","Authentication or payment failure returns 401/402"],"whenToPreferThis":"Use this endpoint when you need the live, current-state portfolio snapshot of a specific wallet address and want Nansen's enriched wallet labeling context (e.g. identifying smart money, entity names). Prefer over generic RPC balance calls when you want aggregated multi-token balances with Nansen's analytics layer. Use Historical Balances sibling endpoint if you need balance changes over time rather than current state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:44:35.582Z","isFirstParty":false}