{"name":"onyx_token_metadata","tier":"metered","price_usdc":"0.001","endpoint":"https://onyx-actions.onrender.com/v1/onyx_token_metadata","method":"POST","input_schema":{"type":"object","properties":{"address":{"type":"string","description":"0x-prefixed ERC-20 contract address on Base"}},"required":["address"]},"description":"ERC-20 token metadata lookup on Base mainnet: name, symbol, decimals, and total supply for any contract address. Use before transacting with a token agents discover at runtime — confirms the contract is a real ERC-20 and resolves human-readable identity. Reads via Base public RPC, ~150-300ms typical. Pairs with onyx_base_tx_decode for full token-flow context. No vendor key needed.","when_to_use":"Use before transacting with any ERC-20 on Base — confirms the address is a real ERC-20, resolves name + symbol + decimals + total supply. Pairs with onyx_base_token_risk_scan for full pre-trade safety.","vs_alternatives":"Alchemy/QuickNode token APIs require API keys + paid tier above free quota. Etherscan's tokeninfo is rate-limited. Onyx $0.001 reads via Base public RPC, no upstream cost, no key. Cheaper than Zapper at $0.001125.","example_request":{"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},"example_response":{"name":"USD Coin","symbol":"USDC","decimals":6,"total_supply":4418662780.025056,"is_erc20":true,"elapsed_ms":285},"settle_to":"0x3fD9ee1373562f894D322B37DFFAd7a5D2b2d78f","network":"base","facilitator":"https://facilitator.xpay.sh","payment_required":true,"free_introspection":true,"note":"GET this URL = free introspection card. POST with x402 payment header to call."}