{"uid":"cap_yCKoO0TRZUmpHiqcPW_Dd","slug":"x402-chain-tools-erc-20-allowance-lookup-8cd7ce8e","name":"x402 Chain Tools – ERC-20 Allowance Lookup","description":"Get the ERC-20 allowance from an owner to a spender.","url":"https://blockchain-api.x402-chain-tools.workers.dev/chain/allowance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Token owner address."},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract address on Base."},"spender":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Spender address."}}},"responseSchema":{"type":"json","example":{"ok":true,"owner":"0x0000000000000000000000000000000000000001","token":"0x0000000000000000000000000000000000000002","network":"eip155:8453","spender":"0x0000000000000000000000000000000000000003","allowance":{"raw":"0","decimals":6,"formatted":"0","unlimited":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ef_CdlA265CD-EGNsXFgu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC-20 token allowance granted by an owner address to a spender address on Base Mainnet.","exampleAgentPrompt":"What's the USDC allowance that 0xAbCd1234...owner has granted to the Uniswap router 0x1234...spender on the token contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913?","exampleUseCases":[{"title":"Pre-trade DeFi approval check","prompt":"Before I swap tokens on Uniswap, can you check how much USDC (token 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) my wallet 0xAaBb...1234 has approved the Uniswap v3 router 0xE592427A0AEce92De3Edee1F18E0157C05861564 to spend on Base?"},{"title":"DeFi protocol security audit","prompt":"Audit my token approvals — tell me how much of my WETH token at 0x4200000000000000000000000000000000000006 I've approved the Aave lending pool 0x...aave to spend from my address 0xMyWallet...5678 on Base Mainnet."},{"title":"Automated allowance monitoring agent","prompt":"Check whether the allowance my treasury address 0xTreasury...9999 has given to our payroll contract 0xPayroll...1111 for USDC on Base is still set to the expected amount, and alert me if it's zero or unlimited."}],"resultDescription":"A JSON object containing the owner, token, network (eip155:8453 for Base Mainnet), and spender addresses, plus an allowance object with the raw value (as a string), decimal precision, human-formatted amount, and a boolean flag indicating whether the allowance is unlimited (max uint256).","failureModes":["Invalid Ethereum address format returns a validation error","Token contract address does not exist on Base returns zero or error","Network congestion may slow RPC response","Non-ERC-20 contract address may return unexpected data or error","Missing required fields (owner, token, or spender) returns a 400 error"],"whenToPreferThis":"Use this endpoint when you need to read ERC-20 token allowances on Base Mainnet specifically, without writing to the blockchain. Prefer this over generic RPC calls when you want a structured, formatted response that includes both raw and human-readable allowance values plus an unlimited-approval flag. Ideal for pre-flight checks before DeFi operations, security audits, and allowance monitoring workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:42.807Z","isFirstParty":false}