Skip to main content
The Orbscan Open API is a REST API that returns JSON. It provides Polymarket wallet activity, positions, deposits and withdrawals, indexed transaction details, and L2 order book history for Crypto-tagged markets.

​
Base URL

All requests go to:
Every endpoint path in this reference is relative to that base. For example, GET /v1/trader/{address}/activity means https://api.orbscan.com/v1/trader/{address}/activity.

​
Authentication

Authenticate every request with an API key. Send it as a Bearer token in the Authorization header. Requests without a valid key return 401.
See Authentication for full details and code samples.
Your API key is a secret. Keep it server-side and never commit it to a public repository or expose it in client-side code.

​
Response format

Success and error responses use the same envelope:
A successful lookup that finds nothing still returns 200 with status_code: "1". List endpoints return an empty data.items array. Transaction lookups return data: null. Wallet resolution returns data.walletAddress: null. Check the endpoint’s data shape rather than relying on the HTTP status alone.

​
Pagination

List endpoints use cursor pagination. Limits and defaults vary by endpoint, so check the endpoint reference before choosing a page size.
  1. Request a page and optionally set limit.
  2. Read data.nextCursor from the response.
  3. If it is not null, pass it back as the cursor query parameter to fetch the next page.
  4. When nextCursor is null, you’ve reached the end.

​
Available endpoints

Numeric Order Book timestamps use Unix milliseconds. Numeric block and trade timestamps use seconds. Fields such as reward createdAt use ISO 8601 strings. See Authentication.
Prices in activity and transaction responses are expressed as decimals from 0 to 1. A price of "0.78" means 78 cents per share.