Polyrankdocs
x402 Agent API

POST /v1/agent/webhooks

Register an agent-owned webhook subscription (trader.fill / market.resolved / signal.smart_money). x402: $0.005 per call, settled in USDC only on a 2xx — a 4xx is free.

POST
/v1/agent/webhooks

Register an agent-owned webhook subscription (trader.fill / market.resolved / signal.smart_money). x402: $0.005 per call, settled in USDC only on a 2xx — a 4xx is free.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/agent/webhooks" \  -H "Content-Type: application/json" \  -d '{    "target_url": "string",    "event_types": [      "trader.fill"    ]  }'
{}
Empty
Empty