# x402Oracle Trade Check

> x402Oracle Trade Check is a paid API for AI agents from api.x402oracle.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Performs a fast pre-trade liveness, freshness, price, payTo address, and chain drift check on an x402 endpoint before committing payment.

## Facts

- Endpoint: GET https://api.x402oracle.com/v1/trade-check?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402oracle-trade-check-a7992e3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RlgPBqMiXGyu6d35bV59H

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402oracle-trade-check-a7992e3d
```

Example prompt: Before paying, do a quick x402Oracle trade check on https://api.someservice.com/v1/data — make sure it's live, the price is under $0.05, and the payTo address is 0xAbCd1234567890abcdef1234567890abcdef1234, with freshness no older than 60 seconds.

## When to prefer this

Use this endpoint when an AI trading agent needs a lightweight, low-latency pre-flight check before committing to an x402 micropayment — especially when price drift, wallet address tampering, or stale endpoints are a concern. Prefer this over the full trust verdict endpoint when speed matters and you only need the fast liveness + drift signals rather than full monitoring history.

## Known failure modes

- Resource URL is not a valid https x402 endpoint — returns validation error
- Target endpoint is unreachable or times out — returns liveness failure
- Price exceeds maxUsdPrice ceiling — returns drift alert
- payTo wallet address differs from expectedPayTo — returns address drift warning
- Response is older than maxAgeSeconds — returns freshness failure
- Malformed wallet address pattern in expectedPayTo — returns schema validation error

## How this service works

Fast pre-trade check for trading agents: liveness, freshness, and price, payTo, and chain drift.

## Output

Returns a trust verdict object indicating whether the x402 endpoint is live, whether its price is within the specified ceiling, whether the payTo wallet address matches expectations, and whether the data is fresh enough — enabling the calling agent to decide safely whether to proceed with payment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "resource"
     ],
     "properties": {
      "resource": {
       "type": "string",
       "pattern": "^https://",
       "maxLength": 2048,
       "minLength": 1,
       "description": "Absolute https x402 endpoint URL to check before sending payment."
      },
      "maxUsdPrice": {
       "type": "string",
       "description": "Optional non-negative USD price ceiling for the checked endpoint."
      },
      "expectedPayTo": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Optional expected receiving wallet address for drift checks."
      },
      "maxAgeSeconds": {
       "type": "string",
       "description": "Optional non-negative integer freshness limit for the trust decision."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "schema": {
     "type": "object"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "v": 1,
  "chain": {
   "value": "base-mainnet",
   "distinct": 1,
   "changed24h": false,
   "changeCount": 0,
   "lastChangeAgeSeconds": null
  },
  "payTo": {
   "value": null,
   "distinct": 0,
   "changed24h": false,
   "changeCount": 0,
   "lastChangeAgeSeconds": null
  },
  "price": {
   "usd": 0.001,
   "currency": "USDC",
   "distinct": 1,
   "changed24h": false,
   "changeCount": 0,
   "lastChangeAgeSeconds": null
  },
  "stale": false,
  "tracked": true,
  "liveness": {
   "successRate": 0.996,
   "p95LatencyMs": 540,
   "lastLatencyMs": 410,
   "consecutiveFailures": 0
  },
  "resource": "https://api.anchor-x402.com/v1/price/token",
  "ageSeconds": 78,
  "observedAt": "2026-06-10T00:00:00.000Z",
  "review_count": 0,
  "review_rating": null,
  "last_reviewed_at": null,
  "verified_reviews": 0,
  "freshnessAgeSeconds": 30,
  "has_verified_reviews": false,
  "weighted_review_rating": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402oracle-trade-check-a7992e3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402oracle.com](https://www.zero.xyz/host/api.x402oracle.com/llms.txt)