> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "Get rate chain price history"
description: "Returns historical, paginated price data for a rolling rate chain (the blended aggregate price). During roll periods the contracts array reports each active contract's normalized weight in the blend. "
api: "GET /api/v1/rates/chains/{id}/prices"
gridGap: 30
---

<Aside full>
  <RequestExample>
    ```bash title="cURL" lines=false
    curl -X GET "https://api.adjacent.markets/api/v1/rates/chains/<id>/prices" \
      -H "Authorization: Bearer <token>"
    ```
  </RequestExample>
</Aside>

<OpenAPIEndpoint {...{"method":"get","path":"/api/v1/rates/chains/{id}/prices","summary":"Get rate chain price history","description":"Returns historical, paginated price data for a rolling rate chain (the blended aggregate price). During roll periods the contracts array reports each active contract's normalized weight in the blend. The id can be a chain ID directly, or a rate ID that references a chain in its description.","parameters":[{"name":"id","in":"path","required":true,"description":"Rate ID or chain ID","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max data points","schema":{"type":"integer","default":100,"minimum":1,"maximum":1000}},{"name":"start","in":"query","description":"Start of date range","schema":{"type":"string","format":"date-time"}},{"name":"end","in":"query","description":"End of date range","schema":{"type":"string","format":"date-time"}},{"name":"interval","in":"query","description":"Aggregation interval (daily, 1day also accepted as aliases for 1d)","schema":{"type":"string","enum":["1min","5min","1hour","1d"],"default":"5min"}},{"name":"sort","in":"query","description":"Sort direction by timestamp","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"page","in":"query","description":"Page number","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","description":"Items per page","schema":{"type":"integer","default":100,"maximum":500}}],"responses":[{"status":"200","description":"Paginated chain price history","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time"},"price":{"type":"number","description":"Blended weighted-average price (0.0-1.0 scale)"},"min_price":{"type":["number","null"]},"max_price":{"type":["number","null"]},"contracts":{"type":"array","items":{"type":"object","properties":{"contract_id":{"type":"string","description":"Market ID of the contributing contract"},"weight":{"type":"number","description":"Normalized weight in the blend (0.0-1.0)"}}}}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"}}}}},"examples":[]},{"status":"400","description":"Invalid interval value","schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"examples":[]},{"status":"404","description":"Chain not found","schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Clerk JWT Bearer token"}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} />