x402station.io API reference

Agent search — find a working x402 API for a task

Describe the task in plain words; get healthy paid x402 endpoints that do it, ranked by text relevance, 24 h probe health and fresh CDP usage. Search only — nothing is called or paid for you.

This HTML page is served by GET /api/v1/find. The paid API operation remains POST /api/v1/find.

Signature
POST /api/v1/find
Pricing
$0.005 USDC
Settlement
x402 v2 · exact · Base mainnet USDC
Canonical
https://x402station.io/api/v1/find

x402 challenge example

HTTP/1.1 402 Payment Required
payment-required: <base64 PaymentRequiredResponse>
www-authenticate: x402
content-type: application/json; charset=utf-8

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://x402station.io/api/v1/find",
    "description": "Agent search — find a working x402 API for a task"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "asset": "USDC",
      "amount": "5000",
      "payTo": "0x4053338C7cB38624C0bc23c900F78Cf8470b4E38",
      "maxTimeoutSeconds": 300
    }
  ]
}

Request body

{
  "query": "translate text",
  "limit": 3,
  "max_price_usdc": 0.05
}

Success response

{
  "query": "translate text",
  "results": [
    {
      "url": "https://api.example.com/v1/translate",
      "price_usdc": "0.005",
      "network": "eip155:8453",
      "score": 0.91,
      "evidence": {
        "probes_24h": 180,
        "uptime_24h_pct": 100,
        "p50_latency_ms": 240
      }
    }
  ]
}

Error codes

statusmeaning
400Malformed JSON body, query not 3-200 chars, bad limit or max_price_usdc.
402Payment required. Decode payment-required, sign x402, retry.
404No healthy endpoint matched. Not charged.
503Query timeout. Not charged; safe to retry.

Notes

Machine-readable links