Macro rate history
Rate history (actual / previous); code is sofr, tgcr, bgcr or on-rrp
GET
/openapi/v1/macro/rates/{code}/historyRefresh: Daily
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | Required | Short code from the list above. Unknown codes return 404 / 400401 |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | Optional | Number of releases. Default 100, maximum 1000 |
Request Example
curl "https://openapi.sosovalue.com/openapi/v1/macro/rates/sofr/history" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Example
[
{
"date": "2026-08-02",
"released_at": 1785715200000,
"actual": "3.65",
"previous": "3.66"
},
{
"date": "2026-07-30",
"released_at": 1785456000000,
"actual": "3.66",
"previous": "3.65"
}
]Response Fields
| Field | Type | Description |
|---|---|---|
| date | String | Release date, yyyy-MM-dd (UTC) |
| released_at | Number | Release time, millisecond epoch |
| actual | String | Published value |
| previous | String | The preceding release's actual value. Omitted on the oldest row of the series |
Notes
- Rows are newest first.
previousis therefore the value of the next element in the array. - Values are strings.
percentvalues are already percentages —"3.65"means 3.65%, do not multiply by 100. dateis the UTC date ofreleased_at. The publication clock time differs per indicator, so a value shown as August 3 on a UTC+8 display can carrydate: "2026-08-02"here. Join series ondatefrom this API, not on dates scraped from a localised page.- There is no forecast field. Unlike Macro Event History, money-market rates carry no market consensus estimate.
- Only releases with a published value are returned — scheduled-but-unpublished dates are excluded.
on-rrpis an amount, not a rate. Recent values range from roughly 3e7 to 2.7e10 USD, so it needs a different axis and formatter from the threepercentindicators. Parse it as an integer-valued decimal, not a float.
Example
# What rates are available curl -sS -H 'x-soso-api-key: YOUR_KEY' \ 'https://openapi.sosovalue.com/openapi/v1/macro/rates' # Last 30 SOFR releases curl -sS -H 'x-soso-api-key: YOUR_KEY' \ 'https://openapi.sosovalue.com/openapi/v1/macro/rates/sofr/history?limit=30' # Overnight reverse repo curl -sS -H 'x-soso-api-key: YOUR_KEY' \ 'https://openapi.sosovalue.com/openapi/v1/macro/rates/on-rrp/history?limit=30'