{"uid":"cap_V2l0t9VYdBPeHVGdRmp56","slug":"base-erc-20-allowance-checker-0d88c18a","name":"Base ERC-20 Allowance Checker","description":"ERC-20 allowance on Base: how much a spender may transfer from an owner, whether the approval is effectively unlimited, the owner's balance, and the amount the spender could move right now.","url":"https://onchaincheck.dev/base/allowance?utm_source=zero.xyz","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":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address that granted the approval"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract on Base"},"spender":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address allowed to spend"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"raw":"0","chain":"base","owner":"0x698229f40EF287c4B470813e95429f8d764E8054","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","spender":"0x000000000022D473030F116dDEE9F6B43aC78BA3","allowance":"0","unlimited":false,"ownerBalance":"0","spendableNow":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5FeFWIK2-suV4hr-x-wVF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 a spender has from an owner on Base, including whether it's unlimited, the owner's balance, and the spendable amount right now.","exampleAgentPrompt":"Check the USDC allowance on Base for owner 0x698229f40EF287c4B470813e95429f8d764E8054 and spender 0x000000000022D473030F116dDEE9F6B43aC78BA3 — I want to know if it's unlimited and how much they can actually move right now.","exampleUseCases":[{"title":"DeFi approval security audit","prompt":"I want to audit my Base wallet approvals — can you check how much the Uniswap Universal Router (0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD) is allowed to spend of my USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) from my address 0x698229f40EF287c4B470813e95429f8d764E8054, and tell me if the approval is unlimited?"},{"title":"Pre-trade allowance verification","prompt":"Before my trading bot executes a swap, check if the Aerodrome router 0x6Cb442acF35158D5eDa88fe602221b67A400D89 has enough allowance to move at least 500 USDC from my wallet 0xABC1234567890abcdef1234567890abcdef12345 on Base — use token address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Revoke candidate identification","prompt":"I think I left a large approval open on Base months ago. Can you look up how much the old contract 0xDEF9876543210fedcba9876543210fedcba98765 is approved to spend of my WETH (0x4200000000000000000000000000000000000006) from my address 0x1111111111111111111111111111111111111111, and confirm whether it's an unlimited allowance?"}],"resultDescription":"A JSON object containing the token symbol, the raw and human-readable allowance, a boolean indicating whether the approval is effectively unlimited, the owner's current token balance, and the amount the spender could transfer right now (min of allowance and balance), all scoped to the Base network.","failureModes":["Invalid address format (not matching 0x[40 hex chars]) returns a validation error","Token address is not a valid ERC-20 contract on Base — may return zero values or an error","No approval exists — returns allowance of 0 and spendableNow of 0, not an error","Network RPC issues on Base may cause timeouts or incomplete data","Calling with an EOA address as the token returns invalid/empty results"],"whenToPreferThis":"Use this endpoint when you need to verify ERC-20 token approvals specifically on the Base network. It provides a complete picture in a single call — allowance, unlimited flag, owner balance, and actual spendable amount — saving multiple on-chain RPC calls. Prefer it over generic RPC queries when you need structured, parsed output ready for agent decision-making, especially for DeFi workflows, security audits, or pre-trade checks on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:50:15.932Z","isFirstParty":false,"canonicalSlug":"base-erc-20-allowance-checker-0d88c18a"}