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

---
title: "Get rate chain details"
description: "Retrieve the full details of a specific rate chain, including its roll configuration and all constituent contracts. The id can be a chain ID directly, or a rate ID that references a chain in its descr"
api: "GET /api/v1/rates/chains/{id}"
gridGap: 30
---

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

<OpenAPIEndpoint {...{"method":"get","path":"/api/v1/rates/chains/{id}","summary":"Get rate chain details","description":"Retrieve the full details of a specific rate chain, including its roll configuration and all constituent contracts. 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"}}],"responses":[{"status":"200","description":"Rate chain details","schema":{"type":"object","properties":{"chain_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"roll_lead_days":{"type":"integer","description":"Days before expiration to start rolling"},"roll_window_days":{"type":"integer","description":"Duration of the roll transition period"},"roll_schedule_type":{"type":["string","null"],"description":"Roll schedule type (e.g. linear_blend, step_change, custom)"},"total_contracts":{"type":"integer"},"active_contracts":{"type":"integer"},"contracts":{"type":"array","items":{"type":"object","properties":{"market_id":{"type":"string"},"start_date":{"type":["string","null"],"format":"date-time"},"end_date":{"type":["string","null"],"format":"date-time"},"is_active":{"type":"boolean"},"platform":{"type":["string","null"]}}}}}},"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"}]}} />