Comprehensive query examples for analyzing Polymarket data using The Graph Protocol subgraphs.
1. Polymarket Main - Subgraph
- Subgraph ID:
QmdyCguLEisTtQFveEkvMhTH7UzjyhnrF9kpvhYeG4QX8a - Purpose: Core Polymarket data including markets, positions, and basic trading activity
- Network: Polygon
- Query Examples: queries/polymarket-main.md
2. Polymarket Profit and Loss - Subgraph
- Subgraph ID:
QmZAYiMeZiWC7ZjdWepek7hy1jbcW3ngimBF9kpvhYeG4QX8a - Purpose: User positions, PnL tracking, and realized profits/losses
- Network: Polygon
- Query Examples: queries/polymarket-pnl.md
3. Polymarket Activity Polygon - Subgraph
- Subgraph ID:
Qmf3qPUsfQ8et6E3QNBmuXXKqUJi91mo5zbsaTkQrSnMAP - Purpose: Split, merge, redemption activities and Neg Risk conversions
- Network: Polygon
- Query Examples: queries/polymarket-activity.md
4. Polymarket Open Interest - Subgraph
- Subgraph ID:
QmbxydtB3MF2yNriAHhsrBmqTx44aaw44jjNFwZNWaW7R6 - Purpose: Open interest tracking for markets and global metrics
- Network: Polygon
- Query Examples: queries/polymarket-open-interest.md
5. Polymarket Orderbook 🆕 Subgraph
- Purpose: Advanced orderbook analytics and market microstructure data - Real-time orderbook depth, bid-ask spreads, liquidity analysis, and trading flow metrics
- Network: Polygon
- Subgraph ID:
QmTBKKxgZwCMoa9swcHCwK29BdQ9oVaZhczUC9XJ6FLpFL - Key Features:
- Real-time orderbook state and depth tracking
- Market microstructure metrics (spreads, liquidity, order flow)
- Trading activity analysis with price impact metrics
- Multi-level market depth visualization
- Order execution and cancellation tracking
- Buy/sell flow imbalance detection
- Query Examples: queries/polymarket-orderbook.md
6. Polymarket Names - Subgraph
- Subgraph ID:
22CoTbEtpv6fURB6moTNfJPWNUPXtiFGRA8h1zajMha3 - IPFS Hash:
QmP6hMoYTYx4dFGs2dYiNnUDsRZ4ybhH9N6C6G19tHQxku - Purpose: Human-readable market titles and questions - Provides the missing link between questionIDs and actual market descriptions
- Network: Polygon
- Key Features:
- Market questions in plain English
- Question initialization and resolution tracking
- Links questionIDs from other subgraphs to readable titles
- Real-time market metadata updates
- Query Examples: queries/polymarket-names.md
- Choose the appropriate subgraph for your analysis needs
- Browse the query examples in the
queries/directory - Modify queries for your specific use case
- Execute queries using The Graph's decentralized network
You can execute these queries using:
- The Graph Explorer
- GraphQL clients like Apollo Client
- HTTP requests to subgraph endpoints
- Programming languages with GraphQL support
NEW: With the Polymarket Names subgraph and the advanced Orderbook subgraphs, you can now build comprehensive trading dashboards with human-readable market titles and real-time market depth data!
// Enhanced market data transformation with names and orderbook depth
function formatAdvancedMarketData(rawMarket, marketNames, orderbookData) {
// Find matching market name from Names subgraph
const marketName = marketNames.find(m =>
m.questionID.toLowerCase() === rawMarket.conditions[0].toLowerCase()
);
// Find matching orderbook data
const orderbook = orderbookData.find(ob =>
ob.marketId === rawMarket.conditions[0]
);
return {
id: rawMarket.id,
volume: formatCurrency(rawMarket.scaledCollateralVolume),
probability: formatProbability(rawMarket.outcomeTokenPrices),
trades: rawMarket.tradesQuantity,
status: getMarketStatus(rawMarket),
title: marketName?.question || "Market title not found",
questionID: rawMarket.conditions[0],
// New orderbook metrics
spread: orderbook?.currentSpread || "N/A",
spreadPercentage: orderbook?.currentSpreadPercentage || "N/A",
bidDepth: orderbook?.totalBidDepth || "0",
askDepth: orderbook?.totalAskDepth || "0",
lastTradePrice: orderbook?.lastTradePrice || "N/A"
};
}
// Multi-subgraph query for comprehensive market data
const comprehensiveMarketQuery = `
query GetCompleteMarketData {
# From Polymarket Main subgraph
fixedProductMarketMakers(first: 10, orderBy: scaledCollateralVolume, orderDirection: desc) {
id
conditions
scaledCollateralVolume
outcomeTokenPrices
tradesQuantity
}
}
`;
const orderbookQuery = `
query GetOrderbookData($marketIds: [String!]) {
orderBooks(where: { marketId_in: $marketIds }) {
id
marketId
totalBidDepth
totalAskDepth
bidDepthLevels
askDepthLevels
lastUpdate
}
spreads(where: { marketId_in: $marketIds }) {
id
marketId
currentSpread
currentSpreadPercentage
avgSpread
lastUpdate
}
orderFills(
where: { marketId_in: $marketIds }
orderBy: timestamp
orderDirection: desc
first: 1
) {
marketId
price
timestamp
}
}
`;
const namesQuery = `
query GetMarketNames($questionIDs: [Bytes!]) {
markets(where: { questionID_in: $questionIDs }) {
questionID
question
creator
timestamp
}
}
`;- Real-time Market Depth: Monitor bid-ask depth and liquidity in real-time
- Market Microstructure Analysis: Advanced metrics for spread analysis and order flow
- Trading Strategy Insights: Price impact analysis and liquidity scoring
- Professional Trading Tools: Order flow imbalance detection and market efficiency metrics
- Enhanced User Experience: Complete market picture with names, prices, and depth data
- Cross-subgraph Analytics: Combine fundamental data with advanced trading metrics
- Real-time Updates: Query frequently for orderbook data as it changes rapidly
- Depth Analysis: Use market depth queries for impact analysis before large trades
- Flow Monitoring: Track order flow imbalances for potential price movement signals
- Spread Tracking: Monitor spreads for market efficiency and trading cost analysis
- Liquidity Scoring: Use liquidity scores to assess market quality and tradability
- Historical Analysis: Combine with other subgraphs for comprehensive market research
Feel free to add more query examples or improve existing ones by submitting a pull request.
