Macro Series
GET/v1/macro
Retrieve macroeconomic time series stored by Vantafin. Call without a category to list available categories (e.g. treasury rates, central bank policy). With a category, returns a series identifier, observation date, value and optional detail object for each observation - ideal for rates dashboards, macro context on research pages and tying equity analysis to the interest-rate environment.
Use cases
- Central bank and Treasury rate dashboards
- Macro context alongside equity research
- Economic indicator charts and alerts
- Risk models that need policy-rate or yield inputs
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| category | string | Macro category; omit to list categories. |
| limit | integer | Max rows (default 500). |
Output parameters
| Field | Type | Description |
|---|---|---|
| results | array | Macro observations or category listing rows. |
| results[].category | string | Macro category key (e.g. treasury_rates). |
| results[].series | string | Series identifier within the category. |
| results[].observed_on | string | Observation date (YYYY-MM-DD). |
| results[].value | float | Primary numeric value for scalar series (e.g. economic_indicator); omitted when the observation uses detail instead. |
| results[].detail | object | Additional structured fields for the observation (e.g. treasury tenor yields keyed m1/y10). |
| results[].updated_at | string | Last update timestamp (ISO 8601). |
| count | integer | Number of rows returned. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_macro(category="treasury_rates")
print(result)Official SDKs (Python, JavaScript, Go, Java, Ruby): github.com/vantafin/vantafin
{
"results": [
{
"category": "treasury_rates",
"series": "",
"observed_on": "2026-06-05",
"detail": {
"y1": 3.88,
"y2": 4.17,
"y3": 4.22,
"y5": 4.29,
"y7": 4.41,
"m1": 3.71,
"m2": 3.71,
"m3": 3.78,
"m6": 3.81,
"y10": 4.55,
"y20": 5.03,
"y30": 5.01
},
"updated_at": "2026-06-06T02:00:00.283756+00:00"
},
{
"category": "treasury_rates",
"series": "",
"observed_on": "2026-06-04",
"detail": {
"y1": 3.82,
"y2": 4.05,
"y3": 4.1,
"y5": 4.18,
"y7": 4.32,
"m1": 3.71,
"m2": 3.7,
"m3": 3.78,
"m6": 3.78,
"y10": 4.47,
"y20": 4.98,
"y30": 4.97
},
"updated_at": "2026-06-06T02:00:00.286453+00:00"
}
],
"count": 500
}