A

AgentOracle Preflight · Preflight

by AgentOracle Preflight

POSTBase

$0.25

per call · USD Coin on Base

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

Endpoint

POST https://aiagentoracle.ai/api/v1/preflight

9

Calls / 30d

1

Unique payers / 30d

Sep 6

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://aiagentoracle.ai/api/v1/preflight", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
  }),
});
const data = await res.json();
cURL
curl -X POST \
  "https://aiagentoracle.ai/api/v1/preflight" \
  -H "Content-Type: application/json" \
  -d '{"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"}' \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "allowanceChecks": [],
  "checkedAt": "2025-12-31T23:59:30Z",
  "contractRisk": {
    "detail": "No contract supplied.",
    "level": "NOT_ASSESSED",
    "value": null
  },
  "dataQuality": "HIGH",
  "decision": "ALLOW",
  "disclaimer": "Informational and non-executable.",
  "expectedPriceImpactPercent": 0.01,
  "expiresAt": "2026-01-01T00:00:30Z",
  "gas": {
    "basis": "ESTIMATED",
    "gasPriceWei": "1000000",
    "usd": 0.02
  },
  "liquidity": {
    "detail": "Reported liquidity.",
    "level": "LOW",
    "value": 10000000
  },
  "marketVolatility": {
    "detail": "Absolute 24h change.",
    "level": "LOW",
    "value": 2
  },
  "priceDeviationPercent": null,
  "reasons": [
    "No elevated risk."
  ],
  "riskScore": 18,
  "simulation": {
    "blockTag": "pending",
    "calldataSelector": "0x12345678",
    "checkedAt": "2025-12-31T23:59:30Z",
    "gasEstimate": "145000",
    "provider": "Base JSON-RPC",
    "returnData": "0x",
    "revertData": null,
    "revertReason": null,
    "status": "SUCCESS",
    "target": "0x2222222222222222222222222222222222222222"
  },
  "slippageRisk": {
    "detail": "Impact and configured slippage.",
    "level": "LOW",
    "value": 1
  },
  "sources": [],
  "walletRisk": {
    "detail": "No wallet evidence queried.",
    "level": "NOT_ASSESSED",
    "value": null
  }
}

Payment details

Pay to0x2fecabdfc849c76fdc28ca13aa0ab392753ef35c
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Onchain Data and the homepage with a featured placement.

Get featured →

More from AgentOracle Preflight & similar services