Skip to main content
GET
/
polymarket
/
orders
Get Orders
curl --request GET \
  --url https://api.aisa.one/apis/v1/polymarket/orders \
  --header 'Authorization: Bearer <token>'
{
  "orders": [
    {
      "token_id": "58519484510520807142687824915233722607092670035910114837910294451210534222702",
      "token_label": "Yes",
      "side": "BUY",
      "market_slug": "bitcoin-up-or-down-july-25-8pm-et",
      "condition_id": "0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57",
      "shares": 4995000,
      "shares_normalized": 4.995,
      "price": 0.65,
      "block_number": 123456789,
      "log_index": 42,
      "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "title": "Will Bitcoin be above $50,000 on July 25, 2025 at 8:00 PM ET?",
      "timestamp": 1757008834,
      "order_hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "user": "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b",
      "taker": "0x8d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 1250,
    "has_more": true,
    "pagination_key": "eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjUxMDk2MTl9"
  }
}
Trade History fetches order data from Polymarket with optional filtering by market, condition, token, time range, and user wallet address. Returns orders that match either primary or secondary token IDs for markets. If no filters are provided, it returns the latest trades happening in real time. Best for: Analyzing trading activity, tracking specific wallet addresses, monitoring real-time trades, building trade history for a market. Endpoint: GET /polymarket/orders
Note: Only one of market_slug, token_id, or condition_id can be provided per request.

​
Example

curl -X GET "https://api.aisa.one/apis/v1/polymarket/orders?market_slug=bitcoin-up-or-down-july-25-8pm-et&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

The response returns an orders array containing trade objects with fields such as token ID, side (BUY/SELL), shares, price, transaction hash, timestamp, and user/taker wallet addresses. A pagination object with has_more and pagination_key fields supports cursor-based pagination through large result sets.

Authorizations

​
Authorization
string
header
required

Your AIsa API key as a Bearer token.

Query Parameters

​
market_slug
string

Filter orders by market slug

Example:

"bitcoin-up-or-down-july-25-8pm-et"

​
condition_id
string

Filter orders by condition ID

Example:

"0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57"

​
token_id
string

Filter orders by token ID

Example:

"58519484510520807142687824915233722607092670035910114837910294451210534222702"

​
start_time
integer

Filter orders from this Unix timestamp in seconds (inclusive)

Example:

1640995200

​
end_time
integer

Filter orders until this Unix timestamp in seconds (inclusive)

Example:

1672531200

​
limit
integer
default:100

Number of orders to return (1-1000)

Required range: 1 <= x <= 1000
Example:

50

​
pagination_key
string

Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object.

Example:

"eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjUxMDk2MTl9"

​
user
string

Filter orders by user (wallet address)

Example:

"0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"

Response

Orders response with pagination

​
orders
object[]
​
pagination
object