Docs/Market Data·API

Market products

Return canonical market products with calendar metadata.

Method: GET
Path: /api/v1/market/products
Auth: Bearer token

Overview

Returns canonical market products, including product metadata and backend-owned calendar grouping. Market Watch should use this endpoint as its product picker source.

Common use cases

- Build Market Watch product selectors
- Display both display_name and compact ticker
- Read calendar_code and timezone as diagnostic metadata

Request URL

Send the request to the base API URL with your product API key in the Authorization bearer header.

GET/api/v1/market/products

HTTP request

GET https://api.tickquote.com/api/v1/market/products
Authorization: Bearer <tkp_api_key>

Parameter

Description

This endpoint does not require query parameters.

Try It Out

Edit query parameters and send a demo or authenticated request from this endpoint page.

GET/api/v1/market/products

Live sandbox

API Key

Use demo_key to try it without an account.

Response

// Response will appear here after sending a request

Response

A successful REST response uses code 0 and message success. Always check code before reading data.

response.json

Sample payload

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "ticker": "XAUUSD",
        "display_name": "XAU/USD",
        "asset_class": "metals",
        "base_currency": "XAU",
        "quote_currency": "USD",
        "status": "active",
        "calendar_code": "METALS_CME_CFD",
        "timezone": "America/New_York",
        "streams": [
          "quote",
          "kline",
          "snapshot"
        ],
        "timeframes": [
          "M1",
          "M5",
          "M15",
          "M30",
          "H1",
          "H4",
          "D1",
          "W1",
          "MN1"
        ]
      }
    ]
  }
}

Examples

The examples below use compact tickers and the Authorization bearer header.

curl

cURL

curl "https://api.tickquote.com/api/v1/market/products" \
  -H "Authorization: Bearer $TICKQUOTE_API_KEY"

request.js

JavaScript

const response = await fetch("https://api.tickquote.com/api/v1/market/products", {
  headers: {
    Authorization: `Bearer ${process.env.TICKQUOTE_API_KEY}`,
  },
})

const payload = await response.json()
if (payload.code !== 0) {
  throw new Error(payload.message)
}

console.log(payload.data)

Field reference

Field

Sample

Description

ticker

XAUUSD

Public compact ticker, for example XAUUSD.

display_name

XAU/USD

Product display label for UI use.

asset_class

metals

Asset class, for example forex, metals, or indices.

base_currency

XAU

Base currency; may be null when unavailable.

quote_currency

USD

Quote currency; may be null when unavailable.

status

active

Product status, for example active.

calendar_code

METALS_CME_CFD

Backend-owned calendar grouping for display or diagnostics, not frontend mapping logic.

timezone

America/New_York

Timezone for the product calendar.

streams

quote,kline,snapshot

WebSocket streams available for this product.

timeframes

M1,M5,M15,M30,H1,H4,D1,W1,MN1

Kline timeframes available for this product.

Important notes

- This is the new canonical product metadata endpoint.
- Do not hard-code ticker to calendar_code mappings.
- Do not expose provider symbols in UI or examples.