{"slug":"api-agentmercantile-com-v1-allowance-exposure-a391e2","title":"Inspect one Base ERC-20 owner/token/spender allowance with same-block balance an","host":"api.agentmercantile.com","method":"POST","resource":"https://api.agentmercantile.com/v1/allowance-exposure","category":"code","description":"Inspect one Base ERC-20 owner/token/spender allowance with same-block balance and token metadata plus factual exposure flags. No wallet access, signing, or transaction execution. Call when you need a same-block Base allowance-versus-balance snapshot for one owner/token/spender triple.","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":220,"reported_calls_30d":4,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"owner":"0x0000000000000000000000000000000000000001","spender":"0x0000000000000000000000000000000000000002","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"owner":{"description":"ERC-20 token owner address. 0x-prefixed 20-byte EVM address.","type":"string"},"spender":{"description":"Spender address. 0x-prefixed 20-byte EVM address.","type":"string"},"token":{"description":"ERC-20 token contract. 0x-prefixed 20-byte EVM address. Zero address is rejected.","type":"string"}},"required":["owner","token","spender"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":true,"properties":{"allowance_adjusted":{"type":["string","null"]},"allowance_balance_exposure_adjusted":{"type":["string","null"]},"allowance_balance_exposure_raw":{"type":["string","null"]},"allowance_covers_current_balance":{"type":"boolean"},"allowance_raw":{"description":"uint256 as a decimal integer string","type":["string","null"]},"balance_adjusted":{"type":["string","null"]},"balance_raw":{"type":["string","null"]},"block_number":{"type":["string","null"]},"effectively_unlimited":{"type":"boolean"},"evidence":{"properties":{"block_number":{"type":["string","null"]},"same_block_reads":{"type":"boolean"},"token_code_present":{"type":["boolean","null"]}},"type":"object"},"limitations":{"items":{"type":"string"},"type":"array"},"machine":{"enum":["VM02"],"type":"string"},"max_uint256_approval":{"type":"boolean"},"methodology_version":{"enum":["allowance-exposure-0.1.0"],"type":"string"},"network":{"enum":["eip155:8453"],"type":"string"},"owner":{"type":"string"},"spender":{"type":"string"},"status":{"enum":["OK","HOLD"],"type":"string"},"token":{"type":"string"},"token_metadata":{"properties":{"decimals":{"type":["integer","null"]},"symbol":{"type":["string","null"]}},"type":"object"}},"required":["status","machine","methodology_version","network","block_number","owner","token","spender","token_metadata","allowance_raw","allowance_adjusted","balance_raw","balance_adjusted","allowance_balance_exposure_raw","allowance_balance_exposure_adjusted","allowance_covers_current_balance","max_uint256_approval","effectively_unlimited","evidence","limitations"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":220,"error":null}],"description_full":"Inspect one Base ERC-20 owner/token/spender allowance with same-block balance and token metadata plus factual exposure flags. No wallet access, signing, or transaction execution. Call when you need a same-block Base allowance-versus-balance snapshot for one owner/token/spender triple.","last_updated":"2026-09-06T01:15:21.793Z","schemes":["exact"]}