Skip to main content
GET
/
api
/
v1
/
rates
/
chains
List rate chains
curl --request GET \
  --url https://api.dev.adjacent.markets/api/v1/rates/chains \
  --header 'Authorization: Bearer <token>'
[
  {
    "chain_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "roll_lead_days": 123,
    "roll_window_days": 123,
    "contracts": [
      {
        "contract_id": "<string>",
        "market_id": "<string>",
        "symbol": "<string>",
        "start_date": "2023-11-07T05:31:56Z",
        "end_date": "2023-11-07T05:31:56Z",
        "is_active": true
      }
    ]
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.dev.adjacent.markets/llms.txt

Use this file to discover all available pages before exploring further.

List all available rate chains. Rate chains provide continuous, rolling benchmarks across sequential contracts. Each chain defines its own roll schedule (linear_blend, step_change, or custom) and timing parameters (roll_lead_days, roll_window_days).

​
Response

​
chains
array
List of rate chains
​
chain_id
string
Unique chain identifier
​
name
string
Chain name
​
description
string
Chain description
​
roll_lead_days
integer
Days before expiration to start rolling
​
roll_window_days
integer
Duration of roll transition period
​
roll_schedule_type
string
Roll schedule type: linear_blend, step_change, custom
​
total_contracts
integer
Total number of contracts in chain
​
active_contracts
integer
Number of currently active contracts
​
contracts
array
List of contracts in the chain
​
contract_id
string
Contract identifier
​
market_id
string
Market ID
​
contract_symbol
string
Contract symbol/ticker
​
start_date
datetime
Contract start date
​
end_date
datetime
Contract end date
​
is_active
boolean
Whether contract is currently active

​
Example Response

{
  "chains": [
    {
      "chain_id": "pres-2024-2028",
      "name": "Presidential 2024-2028",
      "description": "Rolling presidential election contracts",
      "roll_lead_days": 7,
      "roll_window_days": 14,
      "roll_schedule_type": "linear_blend",
      "total_contracts": 4,
      "active_contracts": 2,
      "contracts": [
        {
          "contract_id": "contract_001",
          "market_id": "KXPRESPARTY-2028-D",
          "contract_symbol": "PRES-2028-D",
          "start_date": "2024-01-01T00:00:00Z",
          "end_date": "2025-01-01T00:00:00Z",
          "is_active": true
        }
      ]
    }
  ]
}

​
Example

curl "https://v2.api.adj.news/api/v1/rates/chains" \
  -H "Authorization: Bearer YOUR_TOKEN"

Authorizations

​
Authorization
string
header
required

Clerk JWT Bearer token

Response

200 - application/json

List of rate chains

​
chain_id
string
​
name
string
​
description
string | null
​
roll_lead_days
integer
​
roll_window_days
integer
​
contracts
object[]