{"uid":"cap_fXQpovXmvoDZN9RwC_Ogs","slug":"ethereum-erc-20-allowance-lookup-71ddcb87","name":"Ethereum ERC-20 Allowance Lookup","description":"ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.","url":"https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc20_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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x + 40 hex"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract, 0x + 40 hex"},"spender":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"chain":"ethereum","method":"allowance","result":"0","service":"x402_eth_reads_v1.eth_mainnet_erc20_allowance"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AnmmhkZiC2gPxZMCH5BP5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the raw ERC-20 token allowance a holder (owner) has granted to a spender on Ethereum mainnet.","exampleAgentPrompt":"What's the current ERC-20 allowance that wallet 0xAbCd...1234 (owner) has approved for the Uniswap v2 router 0x7a25...5678 to spend on the USDC contract 0xA0b8...eB48 on Ethereum mainnet?","exampleUseCases":[{"title":"Pre-trade DeFi approval check","prompt":"Before I swap on Uniswap, check whether my wallet 0xAbCd...1234 has already approved the Uniswap v2 router 0x7a25...5678 to spend my USDC at contract 0xA0b8...eB48 on Ethereum mainnet, and tell me the approved amount."},{"title":"Security audit of token approvals","prompt":"I want to audit my token approvals — can you check how much of the DAI token at 0x6B17...1d0F I've approved for the Aave lending pool 0x7d25...9999 from my wallet 0xDEaD...bEEf on Ethereum mainnet?"},{"title":"Smart contract pre-flight validation","prompt":"Before executing the batch transfer in my smart contract, verify that the spender contract at 0xC02a...aC42 has been granted enough allowance by owner 0xBEEF...0001 on the WETH token at 0xC02a...aC42 on Ethereum mainnet."}],"resultDescription":"A JSON object containing a boolean 'ok' field, the chain identifier, the method used, the service name, and most importantly 'result' — the uint256 allowance as a decimal string representing the raw token units approved by the owner for the spender. On failure, an 'error' field is included instead.","failureModes":["Invalid address format (owner, token, or spender not matching 0x + 40 hex pattern) returns validation error","Token contract address is not a valid ERC-20 contract, causing a revert or zero return","Ethereum node unavailability or RPC timeout causes failure","Missing required query parameters (token, owner, spender) results in bad request error","Payment failure (insufficient USDC balance or x402 protocol error) blocks the request"],"whenToPreferThis":"Use this endpoint when you need to read the current ERC-20 allowance on Ethereum mainnet for a specific owner-spender-token triple without writing any transaction. It is ideal for pre-trade checks, approval auditing, and DeFi automation flows where you need the raw uint256 value directly from the contract. Prefer this over general blockchain RPC calls when you want a simple, pay-per-use HTTP GET with no node infrastructure setup required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:39:11.028Z","isFirstParty":false,"canonicalSlug":"ethereum-erc-20-allowance-lookup-71ddcb87"}