{"uid":"cap_C1iQM0AJh6bs9mN2x6hZj","slug":"erc-20-token-allowance-lookup-b51e243d","name":"ERC-20 Token Allowance Lookup","description":"How much of an ERC-20 token a spender is approved to move from an owner's wallet, via allowance, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The approval read every DeFi, swap and trading agent makes before (and after) a transaction to know if an approve is needed. Live public RPC; one paid call.","url":"https://store.agentexchange.work/chain/allowance","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token","owner","spender"],"properties":{"chain":{"type":"string","description":"base|ethereum|optimism|arbitrum|polygon|gnosis (default base)"},"owner":{"type":"string","description":"Token owner wallet (0x...)"},"token":{"type":"string","description":"ERC-20 token contract (0x...)"},"spender":{"type":"string","description":"Approved spender address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"allowance":{"type":"number"},"raw_allowance":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F0mEyvzCQXNHjuOASx3Ve","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.09","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current ERC-20 token allowance that a spender is approved to transfer on behalf of a token owner on a specified blockchain.","exampleAgentPrompt":"What's the current USDC allowance that Uniswap's router (0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD) is approved to spend from my wallet 0xAbC123...4567 on Base?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the chain name, owner address, token address, spender address, token decimals, human-readable allowance amount (e.g. 1000.0), and raw allowance string in base units (e.g. '1000000000' for 1000 USDC with 6 decimals).","failureModes":["Invalid or malformed wallet/contract address returns 400 error","Unsupported chain name returns error or defaults to Base","Token contract that is not a valid ERC-20 may return zero or error","Network timeout if RPC node is unavailable","Zero allowance returned when no approval has been set (not an error, just correct state)"],"whenToPreferThis":"Use this endpoint when you need a quick, no-auth, pay-per-call on-chain read of an ERC-20 token allowance without setting up a node or API key. Ideal for AI agents operating in DeFi workflows on Base, Ethereum, Optimism, Arbitrum, Polygon, or Gnosis that need to verify approval state before executing swaps, transfers, or other protocol interactions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:22.556Z","isFirstParty":false}