Skip to main content
GET
/
api
/
v1
/
rates
/
{id}
Get reference rate details
curl --request GET \
  --url https://v2.api.adj.news/api/v1/rates/{id} \
  --header 'Authorization: Bearer <token>'
{
  "rate_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "methodology": "<string>",
  "sources": [
    {
      "market_id": "<string>",
      "platform": "<string>",
      "weight": 123,
      "latest_price": 123
    }
  ],
  "latest_price": 123,
  "spread": 123
}
Retrieve detailed information about a specific reference rate, including all contributing sources (both active and historical) and their weights.

​
Path Parameters

​
id
string
required
The unique reference rate identifier (e.g., adj_blup).

​
Response

{
  "rate_id": "adj_blup",
  "name": "Adjacent Democratic President",
  "description": "Rolling rate from contract chain 'adj_blup_chain'",
  "methodology": "simple_average",
  "sources": [
    {
      "market_id": "PRES-2024-KH",
      "platform": "kalshi",
      "weight": 0,
      "latest_price": 0.01,
      "end_date": "2025-01-20T00:00:00Z",
      "is_active": false
    },
    {
      "market_id": "0xc6485bb7ea46d7bb89beb9c91e7572ecfc72a6273789496f78bc5e989e4d1638",
      "platform": "polymarket",
      "weight": 0,
      "latest_price": 0.01,
      "end_date": "2025-01-20T00:00:00Z",
      "is_active": false
    },
    {
      "market_id": "KXPRESPARTY-2028-D",
      "platform": "kalshi",
      "weight": 1,
      "latest_price": 0.58,
      "end_date": "2028-11-03T00:00:00Z",
      "is_active": true
    },
    {
      "market_id": "0xb106a3c9d1c59ed8117493dae6459a3ff79369a8f7cddaf62f4a05828b89195e",
      "platform": "polymarket",
      "weight": 1,
      "latest_price": 0.555,
      "end_date": "2028-11-03T00:00:00Z",
      "is_active": true
    }
  ],
  "latest_price": 0.5675,
  "spread": 0.025
}
FieldTypeDescription
rate_idstringUnique identifier
namestringHuman-readable name
descriptionstringDetailed description
methodologystringCalculation methodology used to aggregate sources (e.g., simple_average, volume_weighted_average)
sourcesarrayAll contributing markets in the rate’s contract chain, including historical (inactive) contracts
latest_pricenumberAggregated price (0.0–1.0 scale)
spreadnumberPrice spread across active sources (max − min, 0.0–1.0 scale)

​
Source Fields

FieldTypeDescription
market_idstringPlatform-specific market identifier
platformstringSource platform (e.g., kalshi, polymarket)
weightnumberWeight of this source in the current aggregation. 0 for inactive (historical) contracts; 1 for active contracts under simple_average methodology
latest_pricenumberMost recent price from this source (0.0–1.0 scale)
end_datestring (ISO 8601)Date this contract expires or expired
is_activebooleanWhether this source is currently contributing to the rate

​
Example

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

​
Errors

StatusDescription
404Reference rate not found

Authorizations

​
Authorization
string
header
required

Clerk JWT Bearer token

Path Parameters

​
id
string
required

Rate ID

Response

Rate details

​
rate_id
string
​
name
string
​
description
string | null
​
methodology
string
​
sources
object[]
​
latest_price
number | null
​
spread
number | null