{"uid":"cap_PQvgJf23WkVkUu-EHF3Qg","slug":"nansen-labels-bc84a56b","name":"Nansen Wallet Address Labels","description":"Get labels for a wallet address. Returns non-premium labels only.\n\nLabels include ENS domains, behavioral labels, DeFi labels, CEX labels, and more.\nPremium labels (smart money, alpha trader) are excluded from this endpoint.\n\nUse /api/v1/profiler/address/premium-labels to get all labels including premium ones.\n\nSuccessful empty responses cost 0 credits; nonempty responses cost 100 credits.\nThe upfront balance check still requires 100 credits. Empty first pages for\na specific EVM chain may include a generic hint to use chain=\"all\". The hint does not report whether labels exist on other chains.\nEmpty later pages are also free.","url":"https://api.nansen.ai/api/v1/profiler/address/labels?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"ProfilerAddressLabelsRequest","examples":[{"chain":"ethereum","address":"0x4a7c6899cdcb379e284fbfd045462e751da4c7ce","pagination":{"page":1,"per_page":100}},{"chain":"solana","address":"HuB5nXrX3AY1eCw688hXGdDgNcfWmZL74kXs7VUxLZFw","pagination":{"page":1,"per_page":100}}],"required":["address","chain"],"properties":{"chain":{"enum":["all","arbitrum","arc","avalanche","base","bnb","ethereum","hyperevm","hyperliquid","iotaevm","linea","mantle","monad","optimism","plasma","polygon","robinhood","sei","solana","sonic","tron"],"type":"string","title":"ProfilerLabelsChain","description":"Chains supported for Profiler Address Labels endpoint."},"address":{"type":"string","title":"Address","examples":["0x4a7c6899cdcb379e284fbfd045462e751da4c7ce","HuB5nXrX3AY1eCw688hXGdDgNcfWmZL74kXs7VUxLZFw"],"description":"Wallet address to get labels for"},"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."}},"description":"Request model for Address Labels endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"ProfilerAddressLabelsResponse","required":["pagination","data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"ProfilerAddressLabel","required":["label"],"properties":{"kind":{"type":"array","items":{"type":"string"},"title":"Kind","examples":[["entity","name"],["entity-tag"],[]],"description":"Label type/classifications, such as entity, name, or entity-tag"},"label":{"type":"string","title":"Label","examples":["Token Millionaire","nansen.eth","30D Smart Trader"],"description":"The label name"},"category":{"anyOf":[{"type":"string"}],"title":"Category","examples":["behavioral","social","smart_money"],"description":"Label category (smart_money, behavioral, defi, social, cefi, nft, others)"}},"description":"A single label for a wallet address."},"title":"Data","description":"List of labels for the address"},"hint":{"anyOf":[{"type":"string"}],"title":"Hint","description":"Generic suggestion to use chain='all' on an empty first page for a specific EVM chain. It does not indicate whether labels exist elsewhere."},"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 Address Labels endpoint."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns non-premium behavioral, DeFi, CEX, ENS, and other categorical labels associated with a blockchain wallet address.","exampleAgentPrompt":"Look up the Nansen labels for the Ethereum wallet 0x4a7c6899cdcb379e284fbfd045462e751da4c7ce — I want to see its behavioral, DeFi, and ENS labels, page 1 with up to 100 results.","exampleUseCases":null,"resultDescription":"A paginated list of label objects for the queried wallet address, each containing a label name (e.g. 'Token Millionaire', 'nansen.eth') and a category (e.g. 'behavioral', 'social', 'defi', 'cefi', 'nft'). Only non-premium labels are returned. Pagination metadata indicates the current page and whether it is the last page.","failureModes":["Invalid or unsupported chain enum returns a validation error","Malformed wallet address format causes a 400 bad request","Address with no labels returns an empty data array","Pagination page beyond available results returns empty data with is_last_page=true","Missing required fields (address or chain) returns a 422 unprocessable entity"],"whenToPreferThis":"Use this endpoint when you need to quickly classify or enrich a wallet address with publicly available, non-premium Nansen labels such as ENS names, behavioral tags, DeFi participation, or CEX affiliation. Prefer this over the premium-labels endpoint when smart money or alpha trader labels are not needed and cost or access constraints apply.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:41:57.257Z","isFirstParty":false,"canonicalSlug":"nansen-labels-bc84a56b"}