Exanomic Platform

GET/v2/series

List All Series

Retrieve a paginated list of all available economic data series.

This endpoint returns a comprehensive list of all economic data series available in the Exanomic API. Each series represents a specific economic indicator, metric, or dataset that can be queried for historical observations. The response includes metadata such as series ID, name, description, frequency, and availability dates.

Authentication: Your API key is required to access economic data series.

Query Parameters

Name	Type	Required	Description
`page` default: `1`	integer	Optional	Page number for pagination (1-indexed).
`limit` default: `20`	integer	Optional	Number of results per page (max 100).
`category`	string	Optional	Filter series by category (e.g., "employment", "inflation", "gdp").
`search`	string	Optional	Search series by name or description.
`frequency`	string	Optional	Filter by data frequency: "daily", "weekly", "monthly", "quarterly", "annual".

page

default: 1

integerOptional

Page number for pagination (1-indexed).

limit

default: 20

integerOptional

Number of results per page (max 100).

category

stringOptional

Filter series by category (e.g., "employment", "inflation", "gdp").

search

stringOptional

Search series by name or description.

frequency

stringOptional

Filter by data frequency: "daily", "weekly", "monthly", "quarterly", "annual".

Response Attributes

Name	Type	Required	Description
`data`	array	Required	Array of series objects.
—`id`	string	Required	Unique identifier for the series.
—`name`	string	Required	Human-readable name of the series.
—`description`	string	Required	Detailed description of what the series represents.
—`category`	string	Required	Category classification of the series.
—`frequency`	string	Required	Data update frequency.
—`unit`	string	Optional	Unit of measurement.
—`startDate`	string	Required	ISO 8601 date of first available observation.
—`endDate`	string	Required	ISO 8601 date of most recent observation.
`pagination`	object	Required	Pagination metadata.
—`page`	integer	Required	Current page number.
—`limit`	integer	Required	Results per page.
—`total`	integer	Required	Total number of series available.
—`totalPages`	integer	Required	Total number of pages.

data

arrayRequired

Array of series objects.

id

stringRequired

Unique identifier for the series.

name

stringRequired

Human-readable name of the series.

description

stringRequired

Detailed description of what the series represents.

category

stringRequired

Category classification of the series.

frequency

stringRequired

Data update frequency.

unit

stringOptional

Unit of measurement.

startDate

stringRequired

ISO 8601 date of first available observation.

endDate

stringRequired

ISO 8601 date of most recent observation.

pagination

objectRequired

Pagination metadata.

page

integerRequired

Current page number.

limit

integerRequired

Results per page.

total

integerRequired

Total number of series available.

totalPages

integerRequired

Total number of pages.

Error Responses

401Unauthorized. Invalid or missing API key.

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

429Too many requests. Rate limit exceeded.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please try again later."
  }
}

Notes

Use category and search together to narrow large datasets efficiently.
Pagination is 1-indexed via page and limit.
For production clients, cache metadata and refresh periodically.

API Method

GET /v2/series

Example Usage

curl -X GET "https://api.exanomic.com/v2/series?page=1&limit=50" \
  -H "X-API-Key: your-api-key-here"

Example Response

{
  "data": [
    {
      "id": "UNRATE",
      "name": "Unemployment Rate",
      "description": "The percentage of the labor force that is unemployed.",
      "category": "employment",
      "frequency": "monthly",
      "unit": "percent",
      "startDate": "1948-01-01",
      "endDate": "2024-12-01"
    },
    {
      "id": "CPIAUCSL",
      "name": "Consumer Price Index",
      "description": "Measures the average change in prices paid by urban consumers.",
      "category": "inflation",
      "frequency": "monthly",
      "unit": "index",
      "startDate": "1913-01-01",
      "endDate": "2024-12-01"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1250,
    "totalPages": 63
  }
}

GET/v2/series/{id}

Get Series Details

Retrieve detailed information about a specific economic data series.

Fetch comprehensive metadata for a single series, including its description, category, frequency, unit of measurement, date range, and other relevant information. This endpoint is useful for understanding what data is available before querying observations.

Authentication: Your API key is required to access series details.

Parameters

Name	Type	Required	Description
`id`	string	Required	The unique identifier of the series (e.g., "UNRATE", "CPIAUCSL").

id

stringRequired

The unique identifier of the series (e.g., "UNRATE", "CPIAUCSL").

Response Attributes

Name	Type	Required	Description
`id`	string	Required	Unique identifier for the series.
`name`	string	Required	Human-readable name of the series.
`description`	string	Required	Detailed description of what the series represents.
`category`	string	Required	Category classification.
`frequency`	string	Required	Data update frequency.
`unit`	string	Optional	Unit of measurement.
`startDate`	string	Required	ISO 8601 date of first available observation.
`endDate`	string	Required	ISO 8601 date of most recent observation.
`lastUpdated`	string	Required	ISO 8601 timestamp of last data update.
`source`	string	Optional	Data source organization.

id

stringRequired

Unique identifier for the series.

name

stringRequired

Human-readable name of the series.

description

stringRequired

Detailed description of what the series represents.

category

stringRequired

Category classification.

frequency

stringRequired

Data update frequency.

unit

stringOptional

Unit of measurement.

startDate

stringRequired

ISO 8601 date of first available observation.

endDate

stringRequired

ISO 8601 date of most recent observation.

lastUpdated

stringRequired

ISO 8601 timestamp of last data update.

source

stringOptional

Data source organization.

Error Responses

404Series not found.

{
  "error": {
    "code": "not_found",
    "message": "Series with ID \"INVALID\" not found"
  }
}

401Unauthorized. Invalid or missing Bearer token.

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing Bearer token"
  }
}

Notes

Use this endpoint to validate a series ID before requesting observations.
Metadata fields can be cached client-side to reduce request overhead.

API Method

GET /v2/series/{id}

Example Usage

curl -X GET "https://api.exanomic.com/v2/series/UNRATE" \
  -H "X-API-Key: your-api-key-here"

Example Response

{
  "id": "UNRATE",
  "name": "Unemployment Rate",
  "description": "The percentage of the labor force that is unemployed.",
  "category": "employment",
  "frequency": "monthly",
  "unit": "percent",
  "startDate": "1948-01-01",
  "endDate": "2024-12-01",
  "lastUpdated": "2024-12-15T10:30:00Z",
  "source": "U.S. Bureau of Labor Statistics"
}

Name

Type

Required

Description

page

default: 1

integer

Optional

Page number for pagination (1-indexed).

limit

default: 20

integer

Optional

Number of results per page (max 100).

category

string

Optional

Filter series by category (e.g., "employment", "inflation", "gdp").

search

string

Optional

Search series by name or description.

frequency

string

Optional

Filter by data frequency: "daily", "weekly", "monthly", "quarterly", "annual".

Name

Type

Required

Description

data

array

Required

Array of series objects.

—id

string

Required

Unique identifier for the series.

—name

string

Required

Human-readable name of the series.

—description

string

Required

Detailed description of what the series represents.

—category

string

Required

Category classification of the series.

—frequency

string

Required

Data update frequency.

—unit

string

Optional

Unit of measurement.

—startDate

string

Required

ISO 8601 date of first available observation.

—endDate

string

Required

ISO 8601 date of most recent observation.

pagination

object

Required

Pagination metadata.

—page

integer

Required

Current page number.

—limit

integer

Required

Results per page.

—total

integer

Required

Total number of series available.

—totalPages

integer

Required

Total number of pages.

{ "data": [ { "id": "UNRATE", "name": "Unemployment Rate", "description": "The percentage of the labor force that is unemployed.", "category": "employment", "frequency": "monthly", "unit": "percent", "startDate": "1948-01-01", "endDate": "2024-12-01" }, { "id": "CPIAUCSL", "name": "Consumer Price Index", "description": "Measures the average change in prices paid by urban consumers.", "category": "inflation", "frequency": "monthly", "unit": "index", "startDate": "1913-01-01", "endDate": "2024-12-01" } ], "pagination": { "page": 1, "limit": 20, "total": 1250, "totalPages": 63 } }

Name

Type

Required

Description

id

string

Required

The unique identifier of the series (e.g., "UNRATE", "CPIAUCSL").

Name

Type

Required

Description

id

string

Required

Unique identifier for the series.

name

string

Required

Human-readable name of the series.

description

string

Required

Detailed description of what the series represents.

category

string

Required

Category classification.

frequency

string

Required

Data update frequency.

unit

string

Optional

Unit of measurement.

startDate

string

Required

ISO 8601 date of first available observation.

endDate

string

Required

ISO 8601 date of most recent observation.

lastUpdated

string

Required

ISO 8601 timestamp of last data update.

source

string

Optional

Data source organization.