v2 macro

Preview, not deployed. The v2 gateway is built but not deployed yet; this call works once the owner deploys silo-api.

Macro series, inflation and its item tree, PTAX, Focus expectations.

Example: /v2/macro?kind=inflation

Kinds:

• series: api.macro_series: one SGS series by label or code, oldest first. Refuses above 1000 rows: narrow from/to.
• inflation: api.inflation: the IPCA set by month with acc_12m, 3 years by default. Refuses above 1000 rows: pin id or family, or narrow from.
• inflation_items: api.inflation_items: IBGE’s IPCA tree (weight, monthly change, contribution, year-to-date and 12-month change), 3 years by default. With no id, the groups (level 1); with an id, that item at its own level.
• fx: api.ptax: one currency’s PTAX, BRL per one unit, as published. currency=all reads the api.ptax_daily view, every currency at once.
• expectations: api.focus_expectations: one survey and horizon across survey dates (the weekly revision path), median, mean and standard deviation. Refuses above 1000 rows.

With no from, a dated kind reads the last 12 months to to.

id per kind: series takes a label or SGS code (SELIC_META, CDI, IGPM, 432); inflation one series label (IPCA, IPCA_CORE_EX0, …; none: every series); inflation_items an IBGE structure number or SIDRA item code (none: the groups); expectations a Focus indicator (IPCA, Selic, …; none: every indicator).

BACEN’s IPCA group codes 1640-1643 are Comunicação, Saúde, Despesas pessoais, Educação, as measured against SIDRA. Focus rows are baseCalculo=0 (the trailing 30-day sample); the 12-month inflation survey is unsmoothed. Nothing is filled.

GET /v2/macro?help describes the main parameters, ?help=all adds the hidden ones.

GET /macro

v2 macro

cURL

curl --request GET \
  --url https://zcjbtpxuhdekpwcxmepn.supabase.co/functions/v1/silo-api/v2/macro \
  --header 'apikey: <api-key>'

200

{
  "data": [
    "<unknown>"
  ],
  "meta": {
    "resource": "<string>",
    "kind": "<string>",
    "request": {},
    "id_known": true,
    "endpoint": "<string>"
  },
  "next_page_url": "<string>"
}

Authorizations

apikeyapikey & bearerAuth

apikey · string · header · default: sb_publishable__yfFQsykAglrvc9GS6_PYw_B24ex437 · required

The public publishable key. It identifies the project, not you, and is the anonymous tier.

Query Parameters

kind · enum<string> · default: series

series: one BACEN SGS series. inflation: the IPCA set (headline, cores, groups, diffusion) with 12-month accumulation. inflation_items: IBGE's IPCA item tree with weights. fx: BACEN PTAX buy and sell rates. expectations: the BCB Focus survey path. Default: series.

Available options: series, inflation, inflation_items, fx, expectations

id · string

By kind: series takes an SGS series label or code (SELIC_META, CDI, IGPM, 432); inflation takes one series label (IPCA, IPCA_CORE_EX0, ...; none: every series); inflation_items takes an IBGE structure number or SIDRA item code (none: the groups); expectations takes a Focus indicator (IPCA, Selic, ...; none: every indicator). Required for kind series. Kind fx takes no id. Default: none.

from · string<date>

First date of the window, YYYY-MM-DD. Default: the resource's default window, counted back from to.

to · string<date>

Last date of the window, YYYY-MM-DD. Default: the latest complete period, from coverage.

limit · integer

The page size. More rows than one page come through next_page_url, never cut silently; a call stops at the tier's rows-per-call cap with meta.tier_cap_reached. Default: the tier's page maximum (10 anonymous, 100 signed in); a larger value is coerced to it.

Required range: x >= 1

cursor · string

The opaque cursor from a previous next_page_url. It carries every other parameter: send it alone (another parameter with a different value is bad_request). Default: none: the first page.

family · enum<string> · default: all

Hidden parameter (?help=all lists it). kind inflation: headline, core, classification, diffusion or group (all: every family). kind expectations: the Focus survey, annual (the default), monthly, selic (COPOM meetings) or inflation_12m. Default: all.

Available options: all, headline, core, classification, diffusion, group, annual, monthly, selic, inflation_12m

currency · string · default: USD

Hidden parameter (?help=all lists it). kind fx: an ISO code held (USD, EUR, GBP, JPY, ARS). all: every currency, from the api.ptax_daily view (paged with order + limit + offset). Default: USD.

horizon · string

Hidden parameter (?help=all lists it). kind expectations: the target horizon exactly as BACEN publishes it: a year (2027) for annual, MM/YYYY for monthly, a COPOM meeting (R6/2028) for selic. Default: family annual: the current year (UTC-3); every other survey needs one.

Response

200

application/json

The v2 envelope.

data · any[] · required

Always a list. Rows as the endpoint returned them; null stays null.

meta · object · required

Show child attributes

next_page_url · string

Present only when more rows remain. It carries one opaque cursor.