Polyrankdocs
x402 Agent API

GET /v1/agent/trades/top-roi

Highest-ROI resolved trades, UNMASKED real wallets + exact ROI. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.

GET
/v1/agent/trades/top-roi

Highest-ROI resolved trades, UNMASKED real wallets + exact ROI. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.

Authorization

x402
X-PAYMENT<token>

x402 payment: base64(JSON PaymentPayload) with an EIP-3009 USDC transferWithAuthorization on Base. Call once without it to get the 402 PaymentRequirements; see docs.polyrank.app/x402.

In: header

Query Parameters

limit?integer
category?string
subcategory?string
subtype?string
since_days?integer
sort?string
dir?string

Response Body

application/json

curl -X GET "https://example.com/v1/agent/trades/top-roi"
{}
Empty
Empty

GET /v1/agent/traders/recently-active GET

Most profitable traders (by our metrics) who just traded: 5m–24h windows, unmasked, sortable by any metric (lifetime|30d). Activity is minutes-grain live; metric values are grid cadence. Supports ?since= incremental cursor. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.

GET /v1/agent/webhooks GET

List the caller wallet’s webhook subscriptions (management; payer wallet = identity). x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.