Get API key

Developer guide › Guides

What a TickFeed price response contains, field by field

Before you make a request, see what comes back and what every field means.

The response

Sample response to GET /v1/price/XAUUSD, captured from the live API on 02 November 2026 at 13:49 UTC. It's a real past response, not live data: prices have moved since.

{
  "symbol": "XAUUSD",
  "bid": 3943.0,
  "ask": 3943.17,
  "spread": 0.17,
  "spread_points": 17,
  "point": 0.01,
  "tick_time": "2026-11-02T13:49:13.543000Z",
  "age_seconds": 0.349,
  "freshness": "fresh",
  "market_open": true,
  "stale_after_seconds": 120,
  "source": "live"
}

Every field

FieldIn the sample Meaning
symbol"XAUUSD"The instrument, e.g. XAUUSD (gold in US dollars).
bid3943.0Best price to sell at, in the quote currency (US dollars per troy ounce for gold).
ask3943.17Best price to buy at, same units as bid.
spread0.17ask minus bid, in price units.
spread_points17The same spread counted in points; a point is the smallest price step (see point).
point0.01Size of one point for this symbol: 0.01 for gold, 0.00001 for EUR/USD.
tick_time"2026-11-02T13:49:13.543000Z"When the latest quote arrived, UTC, with milliseconds.
age_seconds0.349How old that quote was when we answered.
freshness"fresh"fresh: current. market_closed: the market is shut, so this is the last quote. stale: older than expected while the market should be trading (a feed problem).
market_opentrueWhether the market is in its scheduled trading session right now.
stale_after_seconds120How old a quote may be, during trading hours, before it counts as stale.
source"live"live, or cache when the feed is briefly interrupted and we return the last real quote.

Make the same request

When you're ready, the first-request guide shows how to get a key and run it.

Cost: one price request: 1 unit. One unit is $0.002 / £0.002 / €0.002 (in your account's currency), taken from your prepaid balance only when the request succeeds. Full prices.

More short guides