Skip to main content
The Orbscan Open API is a REST API that gives you programmatic access to on-chain Polymarket data. It returns JSON for every request — successes and errors alike — and is designed for developers, analysts, and data pipelines that need reliable access to trader activity, wallet transfers, and decoded transaction details.

​
Base URL

Send all requests to the following base URL:
Every endpoint path in this reference is relative to that base. For example, GET /v1/trader/{address}/activity resolves to:

​
Authentication

Every request must include your API key as a Bearer token in the Authorization header. Requests without a valid key return a 401 error. See Authentication for setup instructions and code samples.

​
Response Format

Every response — successful or not — uses the same JSON envelope:
A 200 response with success: true and data: null is not an error — it means your request was valid but no matching record exists. For list endpoints, check whether data.items is an empty array rather than relying on the HTTP status alone.

​
Pagination

The list endpoints support cursor-based pagination. Follow these steps to walk through all pages:
  1. Make your first request, optionally setting limit (default 50, maximum 100).
  2. Read data.nextCursor from the response.
  3. If nextCursor is not null, pass its value as the cursor query parameter on your next request.
  4. Continue until nextCursor is null — that signals the final page.
The response for each page includes a nextCursor field alongside the results:
When you reach the last page, nextCursor is null:

​
Available Endpoints

Prices in activity and transaction responses are expressed in cents (0–100). A price of 78.0 means 78¢ per share, not $78. Keep this in mind when calculating position values or P&L.