{"uid":"cap_ENZUrq9K2ysEW7P0izxmP","slug":"nansen-premium-labels-96950e7c","name":"Nansen Premium Labels","description":"Get all labels for a wallet address, including premium labels.\n\nReturns all labels including smart money labels, alpha trader labels, and public figure tags\nthat are excluded from the standard /labels endpoint.\n\nSuccessful empty responses cost 0 credits; nonempty responses cost 500 credits.\nThe upfront balance check still requires 500 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.\nDerived address names can appear without labels scoped to the requested chain;\nthese make the response nonempty and it costs 500 credits.","url":"https://api.nansen.ai/api/v1/profiler/address/premium-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":"Retrieves all labels for a wallet address including exclusive smart money, alpha trader, and public figure tags not available in the standard labels endpoint.","exampleAgentPrompt":"Pull all Nansen premium labels for the Ethereum wallet 0x4a7c6899cdcb379e284fbfd045462e751da4c7ce — I want to see if it has any smart money, alpha trader, or public figure tags that don't show up in the standard labels.","exampleUseCases":null,"resultDescription":"Returns a paginated list of label objects, each with a label name (e.g. 'Token Millionaire', '30D Smart Trader') and a category (e.g. 'smart_money', 'behavioral', 'social'). Includes premium labels such as smart money signals, alpha trader designations, and public figure identifications that are excluded from the basic /labels endpoint.","failureModes":["Invalid or unsupported chain enum value returns validation error","Malformed wallet address format returns error","Address not found on specified chain returns empty data array","Pagination page/per_page out of bounds returns validation error","Missing required fields (address or chain) returns 422 unprocessable entity"],"whenToPreferThis":"Use this endpoint when you need the full set of Nansen intelligence labels for a wallet, especially premium classifications like smart money tiers, alpha trader tags, and public figure associations. Prefer this over the standard /labels endpoint when completeness of labeling is critical for wallet profiling, due diligence, or signal generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:42:13.569Z","isFirstParty":false,"canonicalSlug":"nansen-premium-labels-96950e7c"}