{"uid":"cap_wrDVUZyjp0IyXJRvvCNnO","slug":"coinopselect-contract-permissions-query-0b171a71","name":"CoinOpSelect Contract Permissions Query","description":"Paid on-chain token, wallet, contract and research data over x402 on Base.","url":"https://coinop.publicvm.com/api/v1/query/contract-permissions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string"},"method":{"type":"string"},"queryParams":{"type":"object","required":["contract"],"properties":{"owner":{"type":"string","description":"Owner address (0x..)"},"spender":{"type":"string","description":"Spender address (0x..)"},"contract":{"type":"string","description":"ERC-20 contract address (0x..)"}}}}},"output":{"type":"object","properties":{"flags":{"type":"array"},"owner":{"type":"string"},"query":{"type":"string"},"chainId":{"type":"number"},"network":{"type":"string"},"spender":{"type":"string"},"contract":{"type":"string"},"allowance":{},"fromCache":{"type":"boolean"},"generatedAt":{"type":"string"},"permissions":{"type":"array"}}}}},"responseSchema":{"type":"json","example":{"flags":[],"owner":"0x..","query":"0x..","chainId":8453,"network":"base","spender":"0x..","contract":"0x..","allowance":null,"fromCache":false,"generatedAt":"2026-01-01T00:00:00.000Z","permissions":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MFn4ejC-mftoZsWHbCwdx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up ERC-20 token allowance and permission data for a given contract, owner, and spender address on Base","exampleAgentPrompt":"Check the ERC-20 token allowance on Base for owner address 0xAbC...123 and spender 0xDeF...456 for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know if the spender has any approved amount.","exampleUseCases":[{"title":"DeFi protocol approval audit","prompt":"What's the current token allowance that the Uniswap router at 0x2626664c2603336E57B271c5C0b26F421741e481 has over my wallet 0xYourWallet for the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?"},{"title":"Security check before token revoke","prompt":"I think I may have approved a sketchy contract to spend my tokens — can you check the permissions and allowance that spender 0xSuspect...789 has on the WETH contract 0x4200000000000000000000000000000000000006 for my address 0xMyWallet...001 on Base?"},{"title":"Agent wallet permission verification","prompt":"Before executing this DeFi strategy, verify whether the agent wallet 0xAgent...555 already has an ERC-20 allowance from 0xUser...999 on the DAI contract 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base so we know if we need to send an approval transaction first."}],"resultDescription":"Returns a JSON object containing the allowance value (or null), a permissions array, flags array, owner and spender addresses, the queried contract address, chainId (8453 for Base), network name, whether data came from cache, and a generatedAt timestamp.","failureModes":["Invalid or malformed contract/owner/spender address returns an error or empty result","Contract address is not an ERC-20 token — allowance field may be null and permissions empty","Network outage or RPC node failure on Base could cause request timeout","Missing required 'contract' query parameter results in a validation error","Non-Base contract addresses (e.g. Ethereum mainnet) will not return valid data as the service is scoped to Base (chainId 8453)"],"whenToPreferThis":"Use this endpoint when you need to check ERC-20 token spending permissions or allowances on the Base network without running your own RPC node. It is ideal for AI agents performing pre-flight checks before DeFi transactions, auditing wallet approvals, or verifying that a spender contract is authorized. Prefer this over generic blockchain RPCs when you want a structured, parsed response rather than raw contract call output, and when operating on Base mainnet specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:23.610Z","isFirstParty":false,"canonicalSlug":"coinopselect-contract-permissions-query-0b171a71"}