> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aionmarket.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Prices History

> Return historical price data for a market asset (CLOB token).

Retrieve time-series price data for a specific market outcome token. Useful for charting, backtesting, and trend analysis.

## Query Parameters

<ParamField query="market" type="string" required>
  CLOB token ID (Polymarket token address). This is the unique identifier for the outcome token you want price history for.
</ParamField>

<ParamField query="startTs" type="number">
  Start timestamp in Unix seconds. Omit to use the server default (beginning of available data).
</ParamField>

<ParamField query="endTs" type="number">
  End timestamp in Unix seconds. Omit to use the current time.
</ParamField>

<ParamField query="interval" type="string">
  Time aggregation interval. One of: `max`, `all`, `1m`, `1w`, `1d`, `6h`, `1h`.
</ParamField>

<ParamField query="fidelity" type="integer" default="1">
  Data fidelity in minutes. Higher values produce coarser data with fewer points. Default is `1` (one-minute granularity).
</ParamField>

<ParamField query="venue" type="string" default="polymarket">
  Trading venue identifier. Default: `polymarket`.
</ParamField>

## Response

<ResponseField name="data.history" type="array">
  Array of price data points.

  <Expandable title="PricePoint">
    <ResponseField name="t" type="number">
      Unix timestamp in seconds.
    </ResponseField>

    <ResponseField name="p" type="number">
      Price at this point in time (0-1 range for prediction markets).
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /markets/prices-history
openapi: 3.1.0
info:
  title: Aion AI Agent API
  description: >-
    API for agent registration, wallet onboarding, market discovery, order
    management, and execution on Aion.
  version: 1.0.0
  contact:
    name: Aion Support
    email: info@aionmarket.com
    url: https://docs.aionmarket.com
servers:
  - url: https://www.aionmarket.com/bvapi
    description: Aion API
security:
  - bearerAuth: []
tags:
  - name: Agent Management
  - name: Market Operations
  - name: Order Management
  - name: Trading
  - name: Kalshi
  - name: Skills
  - name: Wallet Management
  - name: Trades & Leaderboard
  - name: Utilities
  - name: Settings
  - name: Positions & Portfolio
  - name: Fee Charging
paths:
  /markets/prices-history:
    get:
      tags:
        - Market Operations
      summary: Get Prices History
      description: Return historical price data for a market asset (CLOB token).
      operationId: getPricesHistory
      parameters:
        - name: market
          in: query
          required: true
          description: CLOB token ID (Polymarket token address)
          schema:
            type: string
        - name: startTs
          in: query
          required: false
          description: Start timestamp (Unix seconds)
          schema:
            type: number
        - name: endTs
          in: query
          required: false
          description: End timestamp (Unix seconds)
          schema:
            type: number
        - name: interval
          in: query
          required: false
          description: Time aggregation interval
          schema:
            type: string
            enum:
              - max
              - all
              - 1m
              - 1w
              - 1d
              - 6h
              - 1h
        - name: fidelity
          in: query
          required: false
          description: Data fidelity in minutes (default 1)
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: venue
          in: query
          required: false
          description: 'Trading venue (default: polymarket)'
          schema:
            type: string
            default: polymarket
            maxLength: 50
      responses:
        '200':
          description: Historical prices
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 200
                  message:
                    type: string
                    example: success
                  data:
                    $ref: '#/components/schemas/PricesHistoryResponse'
components:
  schemas:
    PricesHistoryResponse:
      type: object
      properties:
        history:
          type: array
          description: Array of price history data points
          items:
            $ref: '#/components/schemas/PricePoint'
    PricePoint:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        price:
          type: number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-default: YOUR_API_KEY

````