Statistics Canada Time Series by Vector ID (Date Range)

statcanwds/vector-series

Returns the published values of one Statistics Canada time series, identified by its vector id, between a start and an end reference date: for each period the value, its decimals, scalar factor, preliminary or revised symbol, status code, release time and frequency code. Values are oldest first. A vector id the service does not know comes back with status FAILED and a text message instead of data. Statistics Canada data, passed through unmodified and served by Omnial; not an official Statistics Canada product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Statistics Canada

Source: Statistics Canada, Web Data Service (time series by vector), reference dates as shown in each data point. Reproduced and distributed on an "as is" basis with the permission of Statistics Canada, under the Statistics Canada Open Licence (statcan.gc.ca/en/terms-conditions/open-licence). Served by Eden Engine; not an official Statistics Canada product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "statcanwds/vector-series" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "statcanwds/vector-series" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "statcanwds/vector-series", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "statcanwds/vector-series", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 20, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "vector_id",
    "start_period",
    "end_period"
  ],
  "properties": {
    "vector_id": {
      "type": "string",
      "pattern": "^[0-9]{1,12}$",
      "description": "The Statistics Canada vector id, digits only and without the leading v, for example 41690973. Shown beside each series in Statistics Canada's data tables. One vector per call."
    },
    "end_period": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "Last reference period to return, as YYYY-MM-DD. A short range returns a short answer; a long range on a daily series returns many points."
    },
    "start_period": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "First reference period to return, as YYYY-MM-DD. A monthly series is dated the first of the month: 2025-01-01 is January 2025."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "status",
    "object"
  ],
  "properties": {
    "object": {
      "properties": {
        "vectorId": {
          "type": "integer"
        },
        "productId": {
          "type": "integer",
          "description": "The table (product id) the vector belongs to."
        },
        "coordinate": {
          "type": "string"
        },
        "vectorDataPoint": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number"
              },
              "refPer": {
                "type": "string",
                "description": "Reference period, YYYY-MM-DD."
              },
              "refPer2": {
                "type": "string"
              },
              "decimals": {
                "type": "integer"
              },
              "refPerRaw": {
                "type": "string"
              },
              "refPerRaw2": {
                "type": "string"
              },
              "statusCode": {
                "type": "integer"
              },
              "symbolCode": {
                "type": "integer"
              },
              "releaseTime": {
                "type": "string"
              },
              "frequencyCode": {
                "type": "integer"
              },
              "scalarFactorCode": {
                "type": "integer"
              },
              "securityLevelCode": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "description": "The data points, oldest first."
        },
        "responseStatusCode": {
          "type": "integer"
        }
      },
      "description": "On SUCCESS an object with `productId`, `coordinate`, `vectorId`, `responseStatusCode` and `vectorDataPoint`; on FAILED a string describing the problem.",
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "SUCCESS, or FAILED for an unknown vector id."
    }
  },
  "description": "The service's envelope for the requested vector: `status` is SUCCESS or FAILED, `object` is the series on success and a text message on failure.",
  "additionalProperties": true
}