# Statistics Canada Economic Data API
> Key Canadian economic indicators from the official Statistics Canada Web Data Service. Pull the Consumer Price Index, the seasonally-adjusted unemployment rate, monthly real GDP, the Bank of Canada policy rate and the national population estimate — look up a single indicator, read a full country snapshot with all of them at once, or fetch the raw time series for any Statistics Canada vector by its id (with as many recent periods as you need). Every value carries the indicator label, its unit and the exact reference period, and always resolves to the latest published observation, so there are no dates to hard-code. Built for dashboards, macro research and CAD currency or rates models that need authoritative Canadian data. Distinct from market and FX feeds, and from our OECD cross-country indicators: this surfaces official Statistics Canada figures.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/statcan-api/..."
```

## Pricing
- **Free** (Free) — 1,780 calls/Mo, 2 req/s
- **Basic** ($13/Mo) — 52,300 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 211,000 calls/Mo, 16 req/s
- **Scale** ($79/Mo) — 872,000 calls/Mo, 40 req/s

## Endpoints

### Reference

#### `GET /v1/indicators` — List curated indicators

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/statcan-api/v1/indicators"
```

**Response:**
```json
{
    "data": {
        "count": 5,
        "indicators": [
            {
                "code": "cpi",
                "unit": "index (2002=100)",
                "label": "Consumer Price Index (all-items, Canada)",
                "vector": 41690973
            },
            {
                "code": "unemployment_rate",
                "unit": "%",
                "label": "Unemployment rate (Canada, seasonally adjusted)",
                "vector": 2062815
            },
            {
                "code": "gdp_monthly",
                "unit": "millions CAD",
                "label": "Monthly real GDP (all industries, chained 2017 $)",
                "vector": 65201210
            },
            {
                "code": "policy_rate",
                "unit": "%",
                "label": "Bank of Canada policy / bank rate",
                "vector": 122530
            },
            {
                "code": "population",
                "unit": "persons",
                "label": "Population estimate (Canada)",
                "vector": 1
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:58.122Z",
        "request_id": "3f5a08c5-d4dc-47da-ae80-31712c8c0e92"
    },
    "status": "ok",
    "message": "Indicators retrieved successfully",
    "success": true
}
```

### Indicators

#### `GET /v1/indicator` — Latest value of one indicator

**Parameters:**
- `code` (query, optional, string) — Indicator code Example: `cpi`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/statcan-api/v1/indicator?code=cpi"
```

**Response:**
```json
{
    "data": {
        "unit": "index (2002=100)",
        "label": "Consumer Price Index (all-items, Canada)",
        "value": 168,
        "period": "2026-04-01",
        "source": "Statistics Canada",
        "vector": 41690973,
        "country": "Canada",
        "indicator": "cpi"
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:58.982Z",
        "request_id": "c8e71622-4628-4dee-80ae-ef80529ca9bd"
    },
    "status": "ok",
    "message": "Indicator retrieved successfully",
    "success": true
}
```

#### `GET /v1/snapshot` — All curated indicators at once

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/statcan-api/v1/snapshot"
```

**Response:**
```json
{
    "data": {
        "source": "Statistics Canada",
        "country": "Canada",
        "indicators": [
            {
                "unit": "index (2002=100)",
                "label": "Consumer Price Index (all-items, Canada)",
                "value": 168,
                "period": "2026-04-01",
                "indicator": "cpi"
            },
            {
                "unit": "%",
                "label": "Unemployment rate (Canada, seasonally adjusted)",
                "value": 6.6,
                "period": "2026-05-01",
                "indicator": "unemployment_rate"
            },
            {
                "unit": "millions CAD",
                "label": "Monthly real GDP (all industries, chained 2017 $)",
                "value": 2339731,
                "period": "2026-03-01",
                "indicator": "gdp_monthly"
            },
            {
                "unit": "%",
                "label": "Bank of Canada policy / bank rate",
                "value": 2.5,
                "period": "2026-05-01",
                "indicator": "policy_rate"
            },
            {
                "unit": "persons",
                "label": "Population estimate (Canada)",
                "value": 41472081,
                "period": "2026-01-01",
                "indicator": "population"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:59.803Z",
        "request_id": "bf583040-628f-49ba-ba8a-202aa5063d23"
    },
    "statu
…(truncated, see openapi.json for full schema)
```

### Series

#### `GET /v1/series` — Raw time series for any vector

**Parameters:**
- `vector` (query, required, string) — Statistics Canada vector id Example: `41690973`
- `periods` (query, optional, string) — Number of recent periods (1-120) Example: `12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/statcan-api/v1/series?vector=41690973&periods=12"
```

**Response:**
```json
{
    "data": {
        "count": 12,
        "source": "Statistics Canada",
        "vector": 41690973,
        "observations": [
            {
                "value": 168,
                "period": "2026-04-01",
                "decimals": 1
            },
            {
                "value": 167.4,
                "period": "2026-03-01",
                "decimals": 1
            },
            {
                "value": 165.9,
                "period": "2026-02-01",
                "decimals": 1
            },
            {
                "value": 165,
                "period": "2026-01-01",
                "decimals": 1
            },
            {
                "value": 165,
                "period": "2025-12-01",
                "decimals": 1
            },
            {
                "value": 165.4,
                "period": "2025-11-01",
                "decimals": 1
            },
            {
                "value": 165.3,
                "period": "2025-10-01",
                "decimals": 1
            },
            {
                "value": 164.9,
                "period": "2025-09-01",
                "decimals": 1
            },
            {
                "value": 164.8,
                "period": "2025-08-01",
                "decimals": 1
            },
            {
                "value": 164.9,
                "period": "2025-07-01",
                "decimals": 1
            },
            {
                "value": 164.4,
                "per
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/statcan-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "name": "Statistics Canada Economic Data API",
        "source": "Statistics Canada Web Data Service (www150.statcan.gc.ca)",
        "country": "Canada",
        "endpoints": [
            {
                "path": "/v1/indicators",
                "description": "List curated indicators"
            },
            {
                "path": "/v1/indicator",
                "description": "Latest value of one indicator (?code=cpi)"
            },
            {
                "path": "/v1/snapshot",
                "description": "All curated indicators at once"
            },
            {
                "path": "/v1/series",
                "description": "Raw time series for any vector (?vector=41690973&periods=12)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public Statistics Canada Web Data Service. Not affiliated with Statistics Canada. Data only; refer to StatCan for authoritative figures.",
        "indicators": [
            "cpi",
            "unemployment_rate",
            "gdp_monthly",
            "policy_rate",
            "population"
        ],
        "description": "Key Canadian economic indicators from the official Statistics Canada Web Data Service: the Consumer Price Index, unemployment rate, monthly real GDP, the Bank of Canada policy rate and the national population estimate. Look 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/statcan-api
OpenAPI spec: https://www.oanor.com/api/statcan-api/openapi.json