> ## Documentation Index > Fetch the complete documentation index at: https://docs.predexon.com/llms.txt > Use this file to discover all available pages before exploring further. # Candlesticks by Token > Get historical OHLCV candlestick data for a single outcome token Fetch OHLCV candlestick data for one specific outcome token. Unlike the [condition-level candlesticks endpoint](/api-reference/markets/candlesticks), prices are **not** normalized - NO-token prices stay as NO prices (e.g. \~\$0.30 in a 70/30 market). Volume is only from trades of this token; summing the YES and NO token volumes over the same window approximates the condition-level volume. **Free & Unlimited.** This endpoint does not count toward your monthly usage limits on any plan. Use this when you need to chart each side of a binary market separately, or when working with a specific token ID rather than a condition ID. ### Intervals | Interval | Value | Max Range | | ---------- | ------------- | ------------------------------------------------ | | Auto | `0` (default) | Picks the best interval based on your time range | | 1 minute | `1` | 7 days | | 5 minutes | `5` | 14 days | | 15 minutes | `15` | 30 days | | 1 hour | `60` | 90 days | | 1 day | `1440` | Unlimited (all-time) | The response includes `first_trade_ts` and `last_trade_ts` - the Unix timestamps of the first and last trades for this token. It also echoes back the resolved `interval` (in minutes) and `interval_seconds` (bucket width), so you know which bucket size was picked when requesting `interval=0`. ## OpenAPI ````yaml GET /v2/polymarket/candlesticks/token/{token_id} openapi: 3.1.0 info: title: Predexon API description: Prediction market data aggregation and matching API version: 2.0.0 servers: - url: https://api.predexon.com security: - apiKey: [] paths: /v2/polymarket/candlesticks/token/{token_id}: get: tags: - polymarket summary: Get Candlesticks By Token description: >- Fetch historical candlestick data for a single outcome token. Returns raw OHLCV data for this specific token — no YES/NO normalization is applied, so NO-token prices stay as NO prices (e.g. ~$0.30 in a 70/30 market). Volume is only from trades of this token; summing the YES and NO token volumes over the same window approximates the condition-level volume. operationId: >- get_candlesticks_by_token_v2_polymarket_candlesticks_token__token_id__get parameters: - name: token_id in: path required: true schema: type: string description: Outcome token ID title: Token Id description: Outcome token ID - name: start_time in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Unix timestamp (seconds) for start of time range title: Start Time description: Unix timestamp (seconds) for start of time range - name: end_time in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: Unix timestamp (seconds) for end of time range title: End Time description: Unix timestamp (seconds) for end of time range - name: interval in: query required: false schema: type: integer description: 'Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d' default: 0 title: Interval description: 'Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CandlesticksResponse' '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: CandlesticksResponse: properties: condition_id: anyOf: - type: string - type: 'null' title: Condition Id description: Market condition ID (set for condition-level candles) token_id: anyOf: - type: string - type: 'null' title: Token Id description: Outcome token ID (set for token-level candles) first_trade_ts: anyOf: - type: integer - type: 'null' title: First Trade Ts description: Unix timestamp of the first trade last_trade_ts: anyOf: - type: integer - type: 'null' title: Last Trade Ts description: Unix timestamp of the last trade interval: type: integer title: Interval description: >- Resolved candle interval in minutes (1, 5, 15, 60, or 1440). Reflects the auto-selected value when interval=0 is requested. interval_seconds: type: integer title: Interval Seconds description: >- Resolved candle interval in seconds — the bucket width of each candlestick candlesticks: items: $ref: '#/components/schemas/CandlestickData' type: array title: Candlesticks description: Array of candlestick data points type: object required: - interval - interval_seconds - candlesticks title: CandlesticksResponse description: Candlesticks endpoint response. ErrorResponse: properties: error: type: string title: Error message: type: string title: Message type: object required: - error - message title: ErrorResponse description: Standard error response. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CandlestickData: properties: end_period_ts: type: integer title: End Period Ts price: $ref: '#/components/schemas/PriceData' volume: type: number title: Volume trades_count: type: integer title: Trades Count type: object required: - end_period_ts - price - volume - trades_count title: CandlestickData description: Individual candlestick data. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError PriceData: properties: open: type: number title: Open high: type: number title: High low: type: number title: Low close: type: number title: Close open_dollars: type: string title: Open Dollars high_dollars: type: string title: High Dollars low_dollars: type: string title: Low Dollars close_dollars: type: string title: Close Dollars mean: type: number title: Mean mean_dollars: type: string title: Mean Dollars previous: type: number title: Previous previous_dollars: type: string title: Previous Dollars type: object required: - open - high - low - close - open_dollars - high_dollars - low_dollars - close_dollars - mean - mean_dollars - previous - previous_dollars title: PriceData description: Price data within candlestick. securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````