Skip to main content
GET
/
api
/
v1
/
rates
List reference rates
curl --request GET \
  --url https://v2.api.adj.news/api/v1/rates \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "rate_id": "<string>",
      "name": "<string>",
      "methodology": "<string>",
      "sources_count": 123,
      "latest_price": 123,
      "spread": 123
    }
  ],
  "meta": {
    "total": 123,
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "has_next": true,
    "has_prev": true
  }
}
List all available reference rates with current prices and source counts. Reference rates are cross-platform benchmarks that aggregate prices from multiple prediction market platforms into a single rate.

​
Query Parameters

​
start_date
datetime
Filter rates with prices after this date. Format: ISO 8601.
​
end_date
datetime
Filter rates with prices before this date. Format: ISO 8601.
​
page
integer
default:1
Page number.
​
per_page
integer
default:100
Items per page (1-500).

​
Response

{
  "data": [
    {
      "rate_id": "adj_blup",
      "name": "Adjacent Democratic President",
      "methodology": "simple_average",
      "sources_count": 4,
      "latest_price": 0.5625,
      "spread": 0.03
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 100,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}
FieldTypeDescription
data array items:
FieldTypeDescription
rate_idstringUnique identifier
namestringHuman-readable name
methodologystringCalculation methodology used to aggregate sources (e.g., simple_average, volume_weighted_average)
sources_countintegerTotal number of contributing markets across the rate’s full contract chain, including both active and historical (inactive) contracts
latest_pricenumberAggregated price (0.0–1.0 scale)
spreadnumberPrice spread across active sources (max − min, 0.0–1.0 scale)
meta object:
FieldTypeDescription
totalintegerTotal number of rates
pageintegerCurrent page number
per_pageintegerItems per page
total_pagesintegerTotal number of pages
has_nextbooleanWhether a next page exists
has_prevbooleanWhether a previous page exists

​
Example

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

Authorizations

​
Authorization
string
header
required

Clerk JWT Bearer token

Query Parameters

​
start_date
string<date-time>
​
end_date
string<date-time>
​
page
integer
default:1
​
per_page
integer
default:100
Required range: x <= 500

Response

200 - application/json

List of rates

​
data
object[]
​
meta
object