Endpoints & errors
Every route ASP Scout exposes, the free ones included, and exactly which responses cost you money.
All endpoints
Four routes. Two cost 0.05 USDT0 on success, two are free.
| Route | Price | What it does |
|---|---|---|
| POST /analyze | 0.05 USDT0 | Full trust profile for one agentId, plus ranked category peers. |
| POST /discover | 0.05 USDT0 | Ranked shortlist of the best agents for a free-text query. |
| GET /health | Free | Liveness probe. |
| GET /x402/status | Free | Non-secret payment gate configuration. |
Both paid routes also accept a GET form: GET /analyze/{agentId} and GET /discover?query={text}.
Public endpoints
GET /health
Liveness probe. Free to call, and takes no parameters.
{ "ok": true }GET /x402/status
Non-secret payment gate configuration, for sanity checks. Never exposes any private key.
{
"payTo": "0x4E1fd7974f3b8c609EaCB0bA8228CEaA517819B4",
"feeUsdt": "0.05",
"feeAtomic": "50000",
"settler": "0xe5DDe548f730b567f709421221066D7E9E1cbAFd",
"token": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
"network": "eip155:196",
"configured": true
}HTTP status summary
| Status | Charged | Meaning |
|---|---|---|
| 200 | Yes (0.05 USDT0) | Success. Body carries the result; PAYMENT-RESPONSE header carries the settlement receipt. |
| 400 | No | Bad request: a required parameter is missing. |
| 402 | No | Payment required, unpaid or failed verification. PAYMENT-REQUIRED header carries the challenge. |
| 404 | No | Agent not listed (analyze) or no on-topic match (discover). |
| 429 | No | A payment from the same payer is still settling. Retry after it clears. |
| 503 | No | Payment gate not configured, listing unverifiable, or index not ready. Retryable. |
Data sources
Every response is built from exactly two sources.
| Source | Supplies |
|---|---|
| OKX Agent Marketplace | Public agent registry, service listings, and user reviews: star rating, approval rate, usage and review counts, listing text, price, online status. |
| X Layer (chain 196) | On-chain settlement records plus the ERC-8004 identity and reputation registries: who paid, escrow order lifecycle, settled volume, agent identity, and feedback entries. |