EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

yields

Available bond yields

https://docs.economicsapi.com/endpoints/getyieldsavailable
gethttps://api.economicsapi.com/v1/yields/available

Find names for government bond yields with q. Returns matching names and aliases, not prices or observations. Copy a returned slug or readable alias into /v1/yields/{slug} for the latest value, or append /history. Each instrument defines its benchmark, unit, frequency and source. Discovery is unmetered.

curl -X GET "https://api.economicsapi.com/v1/yields/available?q=canada" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx"

Authorization

Authorizationstringheaderrequired

Bearer token. API key from your economicsapi dashboard Format: `Bearer sk_live_xxxxxxxxxxxxxxxxxxxx`.

Query parameters

qstringrequired

Name or alias to find

min length 1

Example: "canada"

limitintegerdefault 50

min 1 · max 100

offsetintegerdefault 0

Use next_offset from the previous response

min 0

Response

200Successful Responseapplication/json
dataAvailableInstrument[]required
next_offsetinteger | null
401Missing or invalid API keyapplication/json
errorstring
messagestring
request_idstring
422Validation Errorapplication/json
detailValidationError[]
429Rate limit exceededapplication/json
errorstring
messagestring
request_idstring
Response
{
  "data": [
    {
      "slug": "canada-10y-yield",
      "name": "Canada government 10-year benchmark bond yield",
      "aliases": [
        "canada 10y yield"
      ],
      "category": "yields",
      "currency": "CAD",
      "unit": "percent",
      "frequency": "daily"
    }
  ]
}