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 with all contributing sources.

Path Parameters

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

Response

{
  "rate_id": "pres_2028_d",
  "name": "2028 Presidential Republican",
  "description": "Cross-platform benchmark for Republican 2028 presidential win probability",
  "methodology": "volume_weighted_average",
  "sources": [
    {
      "market_id": "KXPRESPARTY-2028-R",
      "platform": "kalshi",
      "weight": 0.55,
      "latest_price": 47.0
    },
    {
      "market_id": "0x123abc...",
      "platform": "polymarket",
      "weight": 0.45,
      "latest_price": 48.0
    }
  ],
  "latest_price": 47.45,
  "spread": 1.0
}
FieldTypeDescription
rate_idstringUnique identifier
namestringHuman-readable name
descriptionstringDetailed description
methodologystringCalculation methodology
sourcesarrayContributing markets
latest_pricenumberAggregated price
spreadnumberPrice spread (max - min)

Source Fields

FieldTypeDescription
market_idstringMarket identifier
platformstringSource platform
weightnumberWeight in aggregation (0.0-1.0)
latest_pricenumberCurrent market price

Weight Calculation

Reference Rate = (price1 * weight1) + (price2 * weight2)

Example

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

Error

StatusDescription
404Reference rate not found

Authorizations

Authorization
string
header
required

Auth0 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