Docs/Start·01

From zero to live data.

This guide helps you make your first TickQuote Market Data API request and then move into realtime streaming.

Read time: 3 min
Difficulty: Beginner

Prerequisites

Create an Account

Review the plan that fits your rollout. Start with the developer tier to explore payloads and docs, then move to production access when your product is ready for live traffic.

Get Your API Token

Once your account is created, generate an API token from your dashboard. Keep this token secure because it controls access to your account quota and market streams.

Make Your First Request

Use the playground on the right to test the API with your token. Or use curl to make the same request from your terminal.

Install

Use our first-party SDKs or call the raw HTTP endpoints.

npm

TypeScript SDK

npm install @tickquote/sdk

pip

Python SDK

pip install tickquote

Your first request

Use the playground on the right to test the API with your token. Or use curl to make a request from your terminal:

GET/api/v1/market/quotes/latest

200 OK

curl "https://api.tickquote.com/api/v1/market/quotes/latest?tickers=EURUSD,GBPUSD" \
  -H "Authorization: Bearer $TICKQUOTE_API_KEY"

response.json

Normalized payload

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "type": "quote",
        "ticker": "EURUSD",
        "time_msc": 1777100000000,
        "bid": 1.10201,
        "ask": 1.10221,
        "mid": 1.10211,
        "spread": 0.0002
      }
    ]
  }
}

Your first stream

Open the market stream with an Authorization header, then subscribe to quote, snapshot, or kline updates.

endpoint

Product-line socket

wss://api.tickquote.com/api/v1/market/stream

stream.ts

/api/v1/market/stream

import WebSocket from "ws"

const socket = new WebSocket("wss://api.tickquote.com/api/v1/market/stream", {
  headers: { Authorization: `Bearer ${process.env.TICKQUOTE_API_KEY}` },
})

socket.addEventListener("open", () => {
  socket.send(JSON.stringify({
    op: "subscribe",
    tickers: ["EURUSD", "GBPUSD"],
    streams: ["quote"],
  }))
})

Up next

Next Steps

Now that you've made your first request, continue into authentication, quotes, and WebSocket delivery.

Authentication Error codes