{"slug":"blockchain-api-x402-chain-tools-workers-dev-chain-wallet-pre-ef7a01","title":"Check read-only ERC-20 wallet readiness for a planned token spend","host":"blockchain-api.x402-chain-tools.workers.dev","method":"POST","resource":"https://blockchain-api.x402-chain-tools.workers.dev/chain/wallet-preflight","category":"market","description":"Check read-only ERC-20 wallet readiness for a planned token spend.","price_listed":0.002,"price_asked":0.002,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":262,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"amount":"10.5","spender":"0x0000000000000000000000000000000000000003","token":"0x0000000000000000000000000000000000000002","wallet":"0x0000000000000000000000000000000000000001"},"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":{"amount":{"description":"Positive decimal string without scientific notation. Exact fractional precision depends on the token decimals() response.","pattern":"^[0-9]+(?:\\.[0-9]+)?$","type":"string"},"spender":{"description":"Planned spender address.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"token":{"description":"ERC-20 token contract address on Base.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"wallet":{"description":"Base wallet address.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"}},"required":["wallet","token","spender","amount"],"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":false,"properties":{"allowance":{"additionalProperties":false,"properties":{"formatted":{"pattern":"^[0-9]+(?:\\.[0-9]+)?$","type":"string"},"raw":{"pattern":"^[0-9]+$","type":"string"},"sufficient":{"type":"boolean"},"unlimited":{"type":"boolean"}},"required":["raw","formatted","unlimited","sufficient"],"type":"object"},"issues":{"items":{"enum":["NO_NATIVE_GAS_BALANCE","INSUFFICIENT_TOKEN_BALANCE","INSUFFICIENT_ALLOWANCE","SPENDER_NOT_CONTRACT"]},"type":"array"},"limitations":{"maxItems":2,"minItems":2,"prefixItems":[{"const":"native gas check only verifies a non-zero ETH balance"},{"const":"transaction execution is not simulated"}],"type":"array"},"native_balance":{"additionalProperties":false,"properties":{"eth":{"pattern":"^[0-9]+(?:\\.[0-9]+)?$","type":"string"},"has_native_gas_balance":{"type":"boolean"},"wei":{"pattern":"^[0-9]+$","type":"string"}},"required":["wei","eth","has_native_gas_balance"],"type":"object"},"network":{"const":"eip155:8453","type":"string"},"ok":{"const":true,"type":"boolean"},"ready":{"type":"boolean"},"requested_amount":{"additionalProperties":false,"properties":{"decimals":{"maximum":255,"minimum":0,"type":"integer"},"formatted":{"pattern":"^[0-9]+(?:\\.[0-9]+)?$","type":"string"},"raw":{"pattern":"^[0-9]+$","type":"string"}},"required":["formatted","raw","decimals"],"type":"object"},"spender":{"description":"Spender address.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"spender_is_contract":{"type":"boolean"},"token":{"description":"Token contract address.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"token_balance":{"additionalProperties":false,"properties":{"formatted":{"pattern":"^[0-9]+(?:\\.[0-9]+)?$","type":"string"},"raw":{"pattern":"^[0-9]+$","type":"string"},"sufficient":{"type":"boolean"}},"required":["raw","formatted","sufficient"],"type":"object"},"wallet":{"description":"Wallet address.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"}},"required":["ok","network","wallet","token","spender","requested_amount","native_balance","token_balance","allowance","spender_is_contract","ready","issues","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.002,"price_match":true,"latency_ms":262,"error":null}],"description_full":"Check read-only ERC-20 wallet readiness for a planned token spend.","last_updated":"2026-09-01T23:20:37.484Z","schemes":["exact"]}