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.
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
| status | meaning |
|---|---|
400 | Malformed JSON body, query not 3-200 chars, bad limit or max_price_usdc. |
402 | Payment required. Decode payment-required, sign x402, retry. |
404 | No healthy endpoint matched. Not charged. |
503 | Query timeout. Not charged; safe to retry. |
Notes
- Excludes endpoints with open dead_7d / mostly_dead / zombie / decoy_price_extreme flags, prices >= $1000, and anything below 80% uptime over >= 3 probes in 24 h.
- At most 2 results per service. Run /api/v1/preflight on the chosen URL right before paying.