Aman Risk Score — x402 service docs

Request format

POST a JSON body. The request field is required — an empty one is rejected before any payment is accepted, so you can never pay by mistake.

wallet address (e.g. 0xabc...)

Call it in 3 steps (any runtime)

Ask for the price — the 402 quote (free, unpaid)

# the quote is the real protocol response — nothing is charged
curl -s -X POST https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-risk-score \
  -H 'Content-Type: application/json' \
  -d '{"request":"…"}'
# → HTTP 402 + accepts[] (price, payTo, both rails) + extensions

Pay on your rail

# rail 1 (primary) — USDC on Base, standard x402 "exact" scheme:
#   EIP-3009 TransferWithAuthorization, payTo 0xfB5625d44be488414606773244F0De35410b2f39
#   any @x402/fetch or ai-sdk x402 client does this automatically
# rail 2 (secondary) — native AMAN:
#   sign an agent_invoke for the exact price (chainId 1)
#   → POST https://amanchain-relay.gitajhd.workers.dev/api/v1/tx → txId

Replay with the payment proof → result + receipt

# AMAN rail:
curl -s -X POST https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-risk-score \
  -H 'Content-Type: application/json' \
  -d '{"request":"…","payment":{"txId":"<txid>"}}'
# USDC rail: same request with the X-PAYMENT header (v1)
#            or PAYMENT-SIGNATURE header (v2)
# → 200 + paid:true + result + on-chain settlement receipt

The payment flow — verify → settle → refund

1 · Verify

The node checks the payment proof against the real chain: a mined agent_invoke (AMAN) or the Coinbase facilitator's verification (USDC on Base). No database rows — money first becomes consensus fact.

2 · Settle

On success the settlement receipt rides the 200 response (PAYMENT-RESPONSE header + receipt body) and is recorded in the ledger — provable forever via the explorer.

3 · Refund (if execution fails)

If the node accepted the payment but the execution fails, it signs an automatic on-chain refund of the exact price, mined within seconds and recorded with the receipt (no double-refunds). Agent money is never stuck.

Facts

Field	Value
Canonical endpoint	`https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-risk-score`
Method	`POST` (GET returns the same 402 quote)
Category	`risk`
Price	15 AMAN (≈ $9.345035, live on-chain AMM rate) — the 402 quote is always the exact current price
Payment rails	`x402-USDC-base` (primary) · `x402-native-AMAN` (secondary)
Networks	amanchain-mainnet + base (USDC) · chainId 1 · block #169288
Health (self-probe)	active, checked 28s ago — the node probes itself every 5 min; agents never have to try and fail
Proven demand	0 paid AMAN calls · 0 AMAN volume

Machine surfaces for this catalog

OpenAPI: /openapi.json · flat: /services.json · bazaar directory: /x402/discovery?category=risk · own bazaar: /api/x402/bazaar · MCP: POST https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet · llms.txt: /llms.txt