Home DocsPolymarket API

Polymarket API

Access real-time prediction market data including markets, prices, orderbooks, trades, and user positions from Polymarket.

GET/v1/polymarket/markets

List all prediction markets with filtering and pagination

Parameters

Name	Type	Required	Description
limit	number	No	Max results (1-100, default: 20)
page	number	No	Page number (default: 1)
status	string	No	Filter: active, closed, all
sort	string	No	Sort by: volume, liquidity, created

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/markets"

Example Response

{
  "success": true,
  "data": {
    "markets": [
      {
        "id": "0x...",
        "question": "Will Bitcoin reach $100k?",
        "yes_price": 0.65,
        "no_price": 0.35,
        "volume": 1500000,
        "liquidity": 250000
      }
    ]
  }
}

GET/v1/polymarket/markets/{market_id}

Get detailed information about a specific market

Parameters

Name	Type	Required	Description
market_id	string	Yes	Market condition ID

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/markets/{market_id}"

GET/v1/polymarket/markets/{market_id}/price

Get current price for a market

Parameters

Name	Type	Required	Description
market_id	string	Yes	Market condition ID

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/markets/{market_id}/price"

Example Response

{
  "success": true,
  "data": {
    "yes_price": 0.65,
    "no_price": 0.35,
    "timestamp": "2025-12-14T12:00:00.000Z"
  }
}

GET/v1/polymarket/markets/{market_id}/orderbook

Get orderbook with bids and asks

Parameters

Name	Type	Required	Description
market_id	string	Yes	Market condition ID
depth	number	No	Orderbook depth (default: 10)

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/markets/{market_id}/orderbook"

GET/v1/polymarket/markets/{market_id}/trades

Get recent trades for a market

Parameters

Name	Type	Required	Description
market_id	string	Yes	Market condition ID
limit	number	No	Max results (default: 50)

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/markets/{market_id}/trades"

GET/v1/polymarket/search

Search markets by keyword

Parameters

Name	Type	Required	Description
q	string	Yes	Search query
limit	number	No	Max results (default: 20)

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/search"

GET/v1/polymarket/trending

Get trending markets by volume

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/trending"

GET/v1/polymarket/categories

List all market categories

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/categories"

GET/v1/polymarket/users/{wallet}/positions

Get user positions in markets

Parameters

Name	Type	Required	Description
wallet	string	Yes	Wallet address
limit	number	No	Max results (default: 100)

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/users/{wallet}/positions"

GET/v1/polymarket/leaderboard

Get top traders leaderboard

Parameters

Name	Type	Required	Description
timeframe	string	No	day, week, month, all
limit	number	No	Max results (default: 100)

Example Request

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.acceso.dev/v1/polymarket/leaderboard"