Skip to main content
GET
/
api
/
v1
/
rates
/
chains
List rate chains
curl --request GET \
  --url https://v2.api.adj.news/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
      }
    ]
  }
]
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[]