Skip to main content

Join the Graylayer Discord

Request an API key in #api-key-request under the Community tab.
Polymarket has two underlying APIs. The proxy exposes both under different platform keys—you don’t need to know the details of each, just use the right path prefix for what you need.
What you wantPlatform keyExample path
Market/event discovery, tags, series, searchpolymarket/api/v1/polymarket/markets
Live prices, order books, spreadspolymarket-clob/api/v1/polymarket-clob/book?token_id=...
User profiles, positions, tradespolymarket-clob/api/v1/polymarket-clob/profile/{address}
All public endpoints require only your proxy X-API-Key header—no Polymarket credentials.

​
Markets and events

Use the polymarket platform key for market discovery.
MethodPathDescription
GET/api/v1/polymarket/marketsList markets
GET/api/v1/polymarket/markets/{id}Get market by ID
GET/api/v1/polymarket/markets/slug/{slug}Get market by slug
GET/api/v1/polymarket/markets/{id}/tagsMarket tags
GET/api/v1/polymarket/eventsList events
GET/api/v1/polymarket/events/{id}Get event by ID
GET/api/v1/polymarket/events/slug/{slug}Get event by slug
Also available via CLOB (more detail: open interest, positions, live volume):
MethodPathDescription
GET/api/v1/polymarket-clob/marketsList markets
GET/api/v1/polymarket-clob/markets/{id}Get market
GET/api/v1/polymarket-clob/markets/{id}/open-interestOpen interest
GET/api/v1/polymarket-clob/markets/{id}/positionsMarket positions
GET/api/v1/polymarket-clob/markets/{id}/top-holdersTop holders
GET/api/v1/polymarket-clob/events/{id}/live-volumeLive volume

​
Query parameters for market listing

ParameterTypeDescription
limitintegerMax results
offsetintegerPagination offset
activebooleanFilter active markets
closedbooleanFilter closed markets
tag_idstringFilter by tag ID
curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/polymarket/markets?limit=10&active=true"

​
Order book and pricing

Use the polymarket-clob platform key. Token IDs come from the market data above.
MethodPathDescription
GET/api/v1/polymarket-clob/book?token_id=TOKEN_IDFull order book
POST/api/v1/polymarket-clob/bookMultiple order books
GET/api/v1/polymarket-clob/price?token_id=TOKEN_ID&side=BUY|SELLBest price
POST/api/v1/polymarket-clob/pricesBatch prices (up to 500)
GET/api/v1/polymarket-clob/midpoint?token_id=TOKEN_IDMidpoint price
GET/api/v1/polymarket-clob/midpointsBatch midpoints
GET/api/v1/polymarket-clob/spread?token_id=TOKEN_IDBid-ask spread
GET/api/v1/polymarket-clob/spreadsBatch spreads
GET/api/v1/polymarket-clob/last-trade-price?token_id=TOKEN_IDLast trade price
GET/api/v1/polymarket-clob/last-trade-pricesBatch last trade prices
GET/api/v1/polymarket-clob/fee-rate?token_id=TOKEN_IDFee rate
GET/api/v1/polymarket-clob/tick-size?token_id=TOKEN_IDTick size
GET/api/v1/polymarket-clob/timeServer time
curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/polymarket-clob/book?token_id=TOKEN_ID"

​
Price history

MethodPathDescription
GET/api/v1/polymarket-clob/prices-historyHistorical prices
Query parameters: token_id (required), interval (1m, 5m, 1h, 6h, 1d, 1w), fidelity, startTs, endTs. 
curl -H "X-API-Key: your_key" \
  "http://gateway.graylayer.tech/api/v1/polymarket-clob/prices-history?token_id=TOKEN_ID&interval=1d"
MethodPathDescription
GET/api/v1/polymarket/tagsList tags
GET/api/v1/polymarket/tags/{id}Get tag
GET/api/v1/polymarket/tags/slug/{slug}Get tag by slug
GET/api/v1/polymarket/tags/{id}/relatedRelated tags
GET/api/v1/polymarket/seriesList series
GET/api/v1/polymarket/series/{id}Get series
GET/api/v1/polymarket/search?q=QUERYSearch markets, events, profiles
GET/api/v1/polymarket/sportsSports metadata
GET/api/v1/polymarket/sports/typesValid sports market types
GET/api/v1/polymarket/sports/teamsList teams

​
Profiles and positions

MethodPathDescription
GET/api/v1/polymarket-clob/profile/{address}Public profile
GET/api/v1/polymarket-clob/profile/{address}/positions/currentCurrent positions
GET/api/v1/polymarket-clob/profile/{address}/positions/closedClosed positions
GET/api/v1/polymarket-clob/profile/{address}/activityActivity
GET/api/v1/polymarket-clob/profile/{address}/total-valueTotal position value
curl -H "X-API-Key: your_key" \
  http://gateway.graylayer.tech/api/v1/polymarket-clob/profile/0xABC.../positions/current

​
Trades and leaderboards

MethodPathDescription
GET/api/v1/polymarket-clob/tradesTrades by user or market
GET/api/v1/polymarket-clob/leaderboard/tradersTrader leaderboard
GET/api/v1/polymarket-clob/builders/leaderboardBuilder leaderboard
Trade query parameters: user (wallet address), market (condition ID), limit, before.

​
Comments

MethodPathDescription
GET/api/v1/polymarket/commentsList comments
GET/api/v1/polymarket/comments/{commentId}Get comment
GET/api/v1/polymarket/comments/user/{address}Comments by wallet

​
Bridge

MethodPathDescription
GET/api/v1/polymarket-clob/bridge/assetsSupported bridge assets
GET/api/v1/polymarket-clob/bridge/transaction/{id}Transaction status

​
WebSocket

Real-time market data, order updates, and sports scores. See Polymarket WebSockets.