reference_rate

B3 reference-rate curves per session and vertex (b3_reference_rate, TaxaSwap.txt, from 2008-01-02), fixed and moving vertices together. rate_pct is as B3 publishes it, and its basis differs by curve: PRE and DPL are % a.a. on 252 business days, DOC is % a.a. linear on 360 calendar days (api.curve carries rate_basis on every row). The ingest holds PRE, DOC and DPL only. Long vertices are B3’s extrapolation. A GET returns at most 1000 rows, the OLDEST first: filter on curve and trade_date and read Content-Range.

Paging. A GET view pages normally with limit/offset (and Range). Every response is cut at 1000 rows server-side regardless of tier; read Content-Range to detect it (0-999/* is a truncated page, and Prefer: count=exact turns the * into the total).

GET /reference_rate

reference_rate

cURL

curl --request GET \
  --url https://zcjbtpxuhdekpwcxmepn.supabase.co/rest/v1/reference_rate \
  --header 'apikey: <api-key>'

200

[
  {
    "trade_date": "2023-12-25",
    "curve": "<string>",
    "business_days": 123,
    "calendar_days": 123,
    "rate_pct": 123
  }
]

Authorizations

apikey · string · header · required

The publishable key (sb_publishable_…), on every request. It is NOT a JWT — sending it as Authorization: Bearer is rejected as an invalid JWT. It identifies the project, not you, and maps to the Postgres anon role.

Query Parameters

select · string

Columns to return, comma separated. Omit for all of them.

order · string

Sort, e.g. trade_date.desc. Always order a paged read, or limit/offset walk an undefined sequence.

limit · integer

Rows to return. The server cuts every response at 1000 whatever you ask for.

Required range: x <= 1000

offset · integer

Rows to skip. Pairs with limit and order to page.

trade_date · string

PostgREST filter on trade_date — eq., neq., gt., gte., lt., lte., in., is. (e.g. trade_date=eq.<value>).

curve · string

PostgREST filter on curve — eq., neq., gt., gte., lt., lte., in., is. (e.g. curve=eq.<value>).

business_days · string

PostgREST filter on business_days — eq., neq., gt., gte., lt., lte., in., is. (e.g. business_days=eq.<value>).

calendar_days · string

PostgREST filter on calendar_days — eq., neq., gt., gte., lt., lte., in., is. (e.g. calendar_days=eq.<value>).

rate_pct · string

PostgREST filter on rate_pct — eq., neq., gt., gte., lt., lte., in., is. (e.g. rate_pct=eq.<value>).

Response

200

application/json

Matching rows.

trade_date · string<date> | null

curve · string | null

business_days · integer<int32> | null

calendar_days · integer<int32> | null

rate_pct · number | null