{"uid":"cap_atf8QDmdSc7nwvGHkVb4V","slug":"token-brief-metadata-price-holder-concentration-contract-verification-f163a434","name":"Token Brief: Metadata + Price + Holder Concentration + Contract Verification + Sanctions","description":"Token brief: metadata + price + holder concentration + contract verification + sanctions in ONE call — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/token-brief?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["base","ethereum","polygon","arbitrum","optimism"],"type":"string"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"token-brief","parts":[{"name":"evm-token-info","result":{},"available":true}],"receipt":{"tx_hash":"0x<64hex>","amount_usd":0.03,"receipt_id":"g402-<16hex>"},"parts_total":5,"evidence_hash":"sha256:<64hex>","parts_available":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cZO88CPfaiuTVskylpmN-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a consolidated token report including metadata, current price, holder concentration, contract verification status, and sanctions screening for a given EVM token contract in one call.","exampleAgentPrompt":"Can you pull a full token brief for the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need the price, holder concentration, whether the contract is verified, and any sanctions flags?","exampleUseCases":[{"title":"Due diligence on a new DeFi token","prompt":"Before I invest, can you give me a full rundown on this token — contract 0x6982508145454Ce325dDbE47a25d4ec3d2311933 on Ethereum — price, who holds it, is the contract verified, any sanctions issues?"},{"title":"Compliance check on a Base token","prompt":"I need to screen this Base token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 for sanctions risk and also check if the contract is verified before we whitelist it."},{"title":"Token research for a portfolio dashboard","prompt":"Can you fetch the metadata, current price, and holder concentration for the ARB token at 0x912CE59144191C1204E64559FE8253a0e49E6548 on Arbitrum so I can add it to my dashboard?"}],"resultDescription":"A consolidated JSON object containing the token's metadata (name, symbol, decimals, supply), current USD price, holder concentration metrics (e.g. top-holder percentages), contract verification status on the target chain, and sanctions screening result — all in a single response.","failureModes":["Invalid contract address format returns a validation error","Unsupported chain value returns an enum validation error","Unverified or non-existent contract may return partial data or not-found error","Sanctions data provider outage may cause incomplete screening results","Payment failure (x402) blocks the request entirely"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive token snapshot — metadata, price, holder concentration, contract verification, and sanctions — in a single API call rather than stitching together multiple specialized endpoints. Ideal for due diligence workflows, compliance checks, or portfolio enrichment on Base, Ethereum, Polygon, Arbitrum, or Optimism EVM tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:44:05.195Z","isFirstParty":false,"canonicalSlug":"token-brief-metadata-price-holder-concentration-contract-verification-f163a434"}