Orbscan API quickstart: First request in 5 minutes

This guide gets you from zero to a live API response in under five minutes. You’ll obtain an API key, call the trader activity endpoint with a real wallet address, and inspect the JSON response. You can adapt the same request pattern for any other Orbscan endpoint.

Get your API key

Every request to the Orbscan API requires a valid API key. If you don’t have one, use the Orbscan contact form to request access. See Authentication for details.Once you have your key, store it in an environment variable so you can reference it easily:

export ORBSCAN_API_KEY="your_api_key_here"

Fetch trader activity

The trader activity endpoint returns paginated buy, sell, and redeem history for any Polymarket wallet address. Make the following request, replacing the example address with any wallet you want to inspect.

curl -X GET "https://api.orbscan.com/v1/trader/0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee/activity?limit=1&toTimestamp=1782861128" \
  -H "Authorization: Bearer $ORBSCAN_API_KEY" \
  -H "Accept: application/json"

import os
import requests

api_key = os.environ["ORBSCAN_API_KEY"]
address = "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee"

response = requests.get(
    f"https://api.orbscan.com/v1/trader/{address}/activity",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Accept": "application/json",
    },
    params={"limit": 1, "toTimestamp": 1782861128},
)

data = response.json()
print(data)

You can use any valid Polymarket wallet address. Browse the top traders on orbscan.com to find interesting wallets to explore.

Inspect the response

A successful request returns a paginated list of activity records. This response was verified against the request above:

{
  "message": "OK",
  "status_code": "1",
  "data": {
    "items": [
      {
        "blockTimestamp": 1782861128,
        "actionType": "Redeem",
        "price": "1",
        "size": "5",
        "fee": "0",
        "usdcSize": "5",
        "netSharesTransferred": "-5",
        "txHash": "0x71bf46c3089e2349a62ec6b93638522e8cc635a9836f1308ac7621ce1ecbb609",
        "tokenId": "91355094557016369228768123360298492968992168419338047915199416797057852525950",
        "marketId": "2707644",
        "marketSlug": "fifwc-fra-swe-2026-06-30-fra",
        "eventSlug": "fifwc-fra-swe-2026-06-30",
        "conditionId": "0x378f7b5c668014d9f6c42c305ec83902f3c8f6c770b336363aed0076ce6ce1c9",
        "marketTitle": "Will France win on 2026-06-30?",
        "positionSide": "Yes",
        "outcomeIndex": 0,
        "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer ball-bba4025f77.png",
        "traderAddress": "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee",
        "liquidityRole": null
      }
    ],
    "nextCursor": "MTc4Mjg2MTEyOHw4OTQzNzQyMnwzMTY4fDB4NzFiZjQ2YzMwODllMjM0OWE2MmVjNmI5MzYzODUyMmU4Y2M2MzVhOTgzNmYxMzA4YWM3NjIxY2UxZWNiYjYwOTozNDMxOjkxMzU1MDk0NTU3MDE2MzY5MjI4NzY4MTIzMzYwMjk4NDkyOTY4OTkyMTY4NDE5MzM4MDQ3OTE1MTk5NDE2Nzk3MDU3ODUyNTI1OTUwOjB4NmE3MmY2MTgyMGIyNmIxZmU0ZDk1NmUxN2I2ZGMyYTFlYTMwMzNlZQ=="
  }
}

Key fields to note:

Field	Description
`blockTimestamp`	Unix timestamp, in seconds, of the action.
`actionType`	Action label: `Buy`, `Sell`, or `Redeem`.
`price`	Price per share as a decimal from 0 to 1. `"0.78"` means 78 cents per share.
`size`	Number of shares.
`usdcSize`	Gross USDC value of the action.
`netSharesTransferred`	Shares received (positive) or sent (negative).
`nextCursor`	Pass this back as `cursor` to fetch the next page. `null` when no more results.

Next steps

You’ve made your first successful Orbscan API call. Here’s where to go next:

API reference

Base URL, authentication, response envelope, and cursor-based pagination.

Browse endpoints

Positions, portfolio, activity, rewards, deposits & withdrawals, and per-transaction lookups.

Get Started

Trader & transactions

Order Book

Orbscan API quickstart: First request in 5 minutes

API reference

Browse endpoints