{"uid":"cap_rmlW6dyUMCpTHxB-Cqv7_","slug":"x402-onchainexpat-com-e2b9fe43","name":"x402.onchainexpat.com Token Metadata & Security Analysis","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-crypto/token-metadata","method":"POST","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"Blockchain (default: base)"},"address":{"type":"string","description":"Token contract address (0x + 40 hex chars), e.g. '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"name":{"type":"string"},"chain":{"type":"string"},"pools":{"type":"array","description":"Top liquidity pools for this token"},"safety":{"type":"object","description":"Security analysis including honeypot, taxes, mintable, blacklist checks"},"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"},"price_usd":{"type":"number"},"market_cap":{"type":"number"},"risk_level":{"type":"string","description":"Risk level: minimal, low, medium, high"},"risk_score":{"type":"integer","description":"Risk score 0-100 (higher = more risky)"},"volume_24h":{"type":"number"},"holder_count":{"type":"integer"},"liquidity_usd":{"type":"number"},"price_change_24h":{"type":"number"},"contract_verified":{"type":"boolean"}}},"success":{"type":"boolean"}}},"example":{"request":{"chain":"base","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"response":{"data":{"fdv":841163241,"name":"Aerodrome","chain":"base","pools":[{"dex":"quickswap","pair":"USDC/USDbC","chain":"base","liquidity_usd":140532.56},{"dex":"aerodrome","pair":"USDC/USDbC","chain":"base","liquidity_usd":510349.62},{"dex":"alien-base","pair":"USDC/USDbC","chain":"base","liquidity_usd":130648.29},{"dex":"uniswap","pair":"USDC/USDbC","chain":"base","liquidity_usd":908421.58},{"dex":"uniswap","pair":"USDC/USDbC","chain":"base","liquidity_usd":49240.44}],"safety":{"buy_tax":0,"is_proxy":true,"sell_tax":0,"is_honeypot":false,"is_mintable":false,"hidden_owner":false,"external_call":false,"has_blacklist":false,"self_destruct":false,"can_take_ownership":false,"owner_can_change_balance":false},"symbol":"AERO","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":18,"pair_url":"https://dexscreener.com/base/0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d","price_usd":0.4377,"chain_name":"Base","market_cap":418925202,"risk_level":"minimal","risk_score":5,"volume_24h":10784145.16,"top_holders":[{"address":"0x8da91a6298ea5d1a8bc985e99798fd0a0f05701a","balance":"160000000.210698","is_locked":false,"percentage":3.8088897015307213,"is_contract":false},{"address":"0xb026ba5501c9fcdb5b4b746c37e349cd61b81b22","balance":"158707811.660177","is_locked":false,"percentage":3.7781284286805086,"is_contract":false},{"address":"0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb","balance":"153511866.083585","is_locked":false,"percentage":3.6544360313659237,"is_contract":true},{"address":"0xee7ae85f2fe2239e27d9c1e23fffe168d63b4055","balance":"129668008.51253","is_locked":false,"percentage":3.0868196349436667,"is_contract":true},{"address":"0x0ccc149f4c01a2eada3e9f915ca7628920901623","balance":"86991146.922079","is_locked":false,"percentage":2.070873019997024,"is_contract":false},{"address":"0xfa9b1c421ea3fb9974ef155729304f8d3a8c0294","balance":"80000000.072","is_locked":false,"percentage":1.9044448499714688,"is_contract":false},{"address":"0xf76f5123c6b1c49c21adc8903cc571bd875eea4b","balance":"80000000.072","is_locked":false,"percentage":1.9044448499714688,"is_contract":false},{"address":"0xf747d90a25310d437bcc11fe69c01cdd14794afc","balance":"80000000.072","is_locked":false,"percentage":1.9044448499714688,"is_contract":false},{"address":"0xead133f856c70234e530723faf546d88a1baeef2","balance":"80000000.072","is_locked":false,"percentage":1.9044448499714688,"is_contract":false},{"address":"0xe7a12de9afbcb35ec2b7223795702f2b44a80ed9","balance":"80000000.072","is_locked":false,"percentage":1.9044448499714688,"is_contract":false}],"holder_count":9213231,"total_supply":"4200699225.981708","contract_name":null,"liquidity_usd":23531987.12,"owner_address":"0x4fc7850364958d97b4d3f5a08f79db2493f8ca44","creator_address":"0x6aAFF8af0ae8017725312C388bA3745dfE91185B","compiler_version":null,"price_change_24h":-9.07,"contract_verified":false},"cached":false,"success":true,"timestamp":"2026-06-18T05:18:33.616291+00:00"}},"exampleRequest":{"chain":"base","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ymeGAYJzuQ5O7kAVGY1nm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns comprehensive metadata and security analysis for a cryptocurrency token, including contract details, risk flags, and on-chain characteristics","exampleAgentPrompt":"Can you pull up the full token metadata and security analysis for the contract 0x1234...abcd on Base — I want to know if it's safe, who owns it, what the supply looks like, and whether there are any rug-pull red flags?","exampleUseCases":null,"resultDescription":"A JSON object containing comprehensive token metadata such as name, symbol, decimals, total supply, contract address, deployer/owner details, liquidity information, and a security analysis section with risk flags (e.g. honeypot detection, ownership renouncement status, proxy contracts, blacklist functions, and an overall risk score).","failureModes":["Invalid or unrecognized contract address returns an error","Token not found on the specified chain returns 404 or empty result","Unsupported blockchain network returns an error","Malformed request body returns 400 bad request","Payment not included or insufficient USDC returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need both token metadata AND security/risk analysis in a single call, especially for DeFi due diligence on unknown or new tokens. Prefer this over a plain price endpoint when the user's concern is safety, legitimacy, or contract-level details rather than just market data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:40.178Z","isFirstParty":false}