> ## Documentation Index > Fetch the complete documentation index at: https://docs.struct.to/llms.txt > Use this file to discover all available pages before exploring further. # Get combo metrics > Returns combo details and metrics for one or more timeframes. Supports a single timeframe (for example, `1m`), multiple timeframes (for example, `1m,5m,1h`), or `all` to return every timeframe with data. ## OpenAPI ````yaml https://api.struct.to/openapi.json get /polymarket/combos/metrics openapi: 3.1.0 info: title: Polymarket API description: >- RESTful API for querying Polymarket prediction markets data including events, markets, traders, holders, and real-time metrics license: name: '' version: 1.0.0 servers: - url: https://api.struct.to/v1 security: [] paths: /polymarket/combos/metrics: get: tags: - Combos summary: Get combo metrics description: >- Returns combo details and metrics for one or more timeframes. Supports a single timeframe (for example, `1m`), multiple timeframes (for example, `1m,5m,1h`), or `all` to return every timeframe with data. operationId: get_combo_metrics parameters: - name: condition_id in: query description: Combo condition id (0x-prefixed 32-byte hex) required: false schema: type: string - name: position_id in: query description: >- Combo position id, decimal or 0x-prefixed hex. Use this instead of condition_id. required: false schema: type: string - name: timeframe in: query description: >- Timeframe: single (1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d, lifetime), comma-separated (1m,5m,1h), or 'all' required: true schema: type: string responses: '200': description: >- Combo details and metrics for the requested timeframes. The `timeframes` array contains only timeframes that have data for the combo. content: application/json: schema: $ref: '#/components/schemas/ComboMetricsResponse' '400': description: Missing or invalid parameter components: schemas: ComboMetricsResponse: type: object required: - condition_id - timeframes properties: condition_id: type: string description: Combo condition id. creator: type: - string - 'null' description: Address that created the combo. combo_type: type: - string - 'null' description: Combo type. yes_position_id: type: - string - 'null' description: Yes-side position id. no_position_id: type: - string - 'null' description: No-side position id. created_block: type: - integer - 'null' format: int64 created_at: type: - integer - 'null' format: int64 created_tx: type: - string - 'null' first_trade_at: type: - integer - 'null' format: int64 latest_trade_at: type: - integer - 'null' format: int64 status: type: - string - 'null' description: >- Combo state: open, resolved_yes, resolved_no, resolved_split, or resolved_zero. leg_count: type: - integer - 'null' format: int32 legs_won: type: - integer - 'null' format: int32 legs_lost: type: - integer - 'null' format: int32 legs_pending: type: - integer - 'null' format: int32 legs: type: - array - 'null' items: $ref: '#/components/schemas/ComboMarketLeg' implied_probability_yes: type: - number - 'null' format: double implied_probability_no: type: - number - 'null' format: double updated_at: type: - integer - 'null' format: int64 description: Last refresh time in Unix milliseconds. timeframes: type: array items: $ref: '#/components/schemas/ComboTimeframeMetrics' description: Metrics for the requested timeframes. ComboMarketLeg: type: object required: - position_id - v2_condition_id - leg_market_type - outcome_index properties: position_id: type: string description: Position id for this leg. v2_condition_id: type: string description: Alternate condition id form for this leg. condition_id: type: - string - 'null' description: Market condition id for this leg. leg_market_type: type: string description: Type of market this leg belongs to. outcome_index: type: integer format: int32 description: Outcome index selected for this leg. minimum: 0 outcome: type: - string - 'null' description: Display name of the selected outcome. last_price: type: - number - 'null' format: double description: Latest traded price for the selected outcome. status: type: - string - 'null' description: 'Leg result: won, lost, or pending.' market_slug: type: - string - 'null' event_slug: type: - string - 'null' question: type: - string - 'null' title: type: - string - 'null' image_url: type: - string - 'null' ComboTimeframeMetrics: type: object required: - timeframe - legs_won - legs_lost - legs_pending - usd_volume - usd_buy_volume - usd_sell_volume - shares_volume - shares_buy_volume - shares_sell_volume - fees - builder_fees - builder_usd_volume - builder_usd_buy_volume - builder_usd_sell_volume - builder_shares_volume - builder_shares_buy_volume - builder_shares_sell_volume - txns - buys - sells - builder_txns - builder_buys - builder_sells - unique_traders - unique_makers - unique_takers - unique_builder_traders - lifecycle_shares - redeemed_payout - compressed_collateral_out - execution_count - status_update_count - positions_split_count - positions_merged_count - split_on_condition_count - merged_on_condition_count - extracted_count - injected_count - converted_to_yes_basket_count - merged_from_yes_basket_count - compressed_count - redeemed_count - wrapped_count - unwrapped_count - horizontal_split_count - horizontal_merge_count - position_converted_count - migrated_count - updated_at properties: timeframe: type: string status: type: - string - 'null' legs_won: type: integer format: int32 legs_lost: type: integer format: int32 legs_pending: type: integer format: int32 implied_probability_yes: type: - number - 'null' format: double implied_probability_no: type: - number - 'null' format: double usd_volume: type: number format: double usd_buy_volume: type: number format: double usd_sell_volume: type: number format: double shares_volume: type: number format: double shares_buy_volume: type: number format: double shares_sell_volume: type: number format: double fees: type: number format: double builder_fees: type: number format: double builder_usd_volume: type: number format: double builder_usd_buy_volume: type: number format: double builder_usd_sell_volume: type: number format: double builder_shares_volume: type: number format: double builder_shares_buy_volume: type: number format: double builder_shares_sell_volume: type: number format: double txns: type: integer format: int64 buys: type: integer format: int64 sells: type: integer format: int64 builder_txns: type: integer format: int64 builder_buys: type: integer format: int64 builder_sells: type: integer format: int64 unique_traders: type: integer format: int64 unique_makers: type: integer format: int64 unique_takers: type: integer format: int64 unique_builder_traders: type: integer format: int64 price: type: - number - 'null' format: double avg_trade_usd: type: - number - 'null' format: double avg_buy_usd: type: - number - 'null' format: double avg_sell_usd: type: - number - 'null' format: double avg_trade_shares: type: - number - 'null' format: double avg_buy_shares: type: - number - 'null' format: double avg_sell_shares: type: - number - 'null' format: double lifecycle_shares: type: number format: double redeemed_payout: type: number format: double compressed_collateral_out: type: number format: double execution_count: type: integer format: int64 status_update_count: type: integer format: int64 positions_split_count: type: integer format: int64 positions_merged_count: type: integer format: int64 split_on_condition_count: type: integer format: int64 merged_on_condition_count: type: integer format: int64 extracted_count: type: integer format: int64 injected_count: type: integer format: int64 converted_to_yes_basket_count: type: integer format: int64 merged_from_yes_basket_count: type: integer format: int64 compressed_count: type: integer format: int64 redeemed_count: type: integer format: int64 wrapped_count: type: integer format: int64 unwrapped_count: type: integer format: int64 horizontal_split_count: type: integer format: int64 horizontal_merge_count: type: integer format: int64 position_converted_count: type: integer format: int64 migrated_count: type: integer format: int64 updated_at: type: integer format: int64 description: Last refresh time in Unix milliseconds. ````