Prediction Router
API Reference

Users

Public trade history for a user on a platform

Fetch a user's public trade history, scoped to one platform.

All endpoints require Authorization: Bearer <key>.

Base URL: https://prediction-router-api.kalashshah47.workers.dev

Platform support: polymarket. Other platforms return 405 UNSUPPORTED_OPERATION.

The :handle is the user's Polymarket wallet address.


GET /v1/users/:handle/trades

Fetch a user's public trade history.

Query parameters

ParameterTypeRequiredDescription
platformstring✓polymarket
limitintegerMax results. Default 100, max 1000
offsetintegerPagination offset (Polymarket). Default 0

Response

{
  "trades": [
    {
      "id": "0xhash",
      "platform": "polymarket",
      "marketId": "0xcondition",
      "outcome": "Yes",
      "side": "buy",
      "price": 0.55,
      "size": 12,
      "timestamp": "2024-11-14T22:13:20.000Z"
    }
  ]
}

Errors

StatusCodeMeaning
400VALIDATION_ERRORplatform missing or unknown
405UNSUPPORTED_OPERATIONPlatform does not expose this resource