Must-call before Base send/swap/bridge/stake/contract_call
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
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://aiagentoracle.ai/api/v1/preflight
| Category | Everything else |
|---|---|
| Provider host | aiagentoracle.ai |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 9 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"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"
}
Promised output schema (from the provider)
{
"$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"