{"slug":"aiagentoracle-ai-api-v1-preflight-a37be8","title":"Must-call before Base send/swap/bridge/stake/contract_call","host":"aiagentoracle.ai","method":"POST","resource":"https://aiagentoracle.ai/api/v1/preflight","category":"other","description":"Must-call before Base send/swap/bridge/stake/contract_call: returns decision ALLOW|REVIEW|BLOCK plus riskScore, simulation/allowance evidence, reasons[], and expiresAt. Agents must abort on BLOCK, escalate on REVIEW, and only sign/submit on ALLOW while now < expiresAt. Optional unsigned tx + allowan","price_listed":0.25,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":9,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"action":"contract_call","allowanceChecks":[{"owner":"0x1111111111111111111111111111111111111111","requiredAmount":"100000000","spender":"0x2222222222222222222222222222222222222222","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"amountUsd":100,"contractAddress":"0x2222222222222222222222222222222222222222","fromToken":"USDC","network":"eip155:8453","transaction":{"data":"0x12345678","from":"0x1111111111111111111111111111111111111111","to":"0x2222222222222222222222222222222222222222"},"walletAddress":"0x1111111111111111111111111111111111111111"},"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":{"action":{"enum":["swap","transfer","bridge","stake","contract_call"],"type":"string"},"allowanceChecks":{"items":{"additionalProperties":false,"properties":{"owner":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"requiredAmount":{"pattern":"^[0-9]+$","type":"string"},"spender":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"token":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["token","owner","spender","requiredAmount"],"type":"object"},"maxItems":10,"type":"array"},"amountUsd":{"exclusiveMinimum":0,"type":"number"},"contractAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"fromToken":{"type":"string"},"maxSlippageBps":{"maximum":10000,"minimum":0,"type":"integer"},"network":{"enum":["base","eip155:8453"],"type":"string"},"toToken":{"type":"string"},"transaction":{"additionalProperties":false,"properties":{"data":{"maxLength":131074,"pattern":"^0x(?:[a-fA-F0-9]{2})*$","type":"string"},"from":{"description":"Sender context. If omitted along with walletAddress, simulation cannot automatically ALLOW.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"to":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"value":{"pattern":"^0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)$","type":"string"}},"required":["to","data"],"type":"object"},"walletAddress":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["network","action","fromToken","amountUsd"],"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":{"properties":{"allowanceChecks":{"items":{"type":"object"},"type":"array"},"checkedAt":{"format":"date-time","type":"string"},"contractRisk":{"type":"object"},"dataQuality":{"enum":["HIGH","MEDIUM","LOW"],"type":"string"},"decision":{"enum":["ALLOW","REVIEW","BLOCK"],"type":"string"},"disclaimer":{"type":"string"},"expectedPriceImpactPercent":{"type":["number","null"]},"expiresAt":{"format":"date-time","type":"string"},"gas":{"type":"object"},"liquidity":{"type":"object"},"marketVolatility":{"type":"object"},"priceDeviationPercent":{"type":["number","null"]},"reasons":{"items":{"type":"string"},"type":"array"},"riskScore":{"maximum":100,"minimum":0,"type":"integer"},"simulation":{"type":"object"},"slippageRisk":{"type":"object"},"sources":{"items":{"type":"object"},"type":"array"},"walletRisk":{"type":"object"}},"required":["decision","riskScore","gas","liquidity","slippageRisk","contractRisk","marketVolatility","walletRisk","simulation","allowanceChecks","reasons","checkedAt","expiresAt","sources","disclaimer"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Must-call before Base send/swap/bridge/stake/contract_call: returns decision ALLOW|REVIEW|BLOCK plus riskScore, simulation/allowance evidence, reasons[], and expiresAt. Agents must abort on BLOCK, escalate on REVIEW, and only sign/submit on ALLOW while now < expiresAt. Optional unsigned tx + allowanceChecks strengthen evidence; omit sender → REVIEW. $0.25 USDC via x402. Docs: https://aiagentoracle.ai/docs/preflight","last_updated":"2026-09-06T12:33:04.145Z","schemes":["exact"]}