Your first TickFeed request: the live gold price

Get one live gold quote with a single request, and see exactly what comes back.

What you'll get

One request returns the current gold (XAUUSD) quote: bid, ask, spread, the time of the latest tick and a freshness label. Here's a real 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"
}

1. Get your API key

Sign in and open API keys. Create a key; it's shown once, so copy it then.
Keep it out of your code: put it in an environment variable, e.g. export TICKFEED_API_KEY=mdp_your_key_here (macOS/Linux) or setx TICKFEED_API_KEY mdp_your_key_here (Windows, then open a new terminal).
Never email or paste the key anywhere public. If it leaks, revoke it in the dashboard and create a new one.

2. Run the request

With curl:

curl -H "X-API-Key: $TICKFEED_API_KEY" https://api.tickfeed.pro/v1/price/XAUUSD

Or in Python, with the official client (pip install tickfeed, standard library only):

from tickfeed import TickFeed

tf = TickFeed()            # reads TICKFEED_API_KEY
p = tf.price("XAUUSD")
print(p["bid"], p["ask"], p["freshness"])

Cost: this 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.

3. Check the response

bid and ask are in US dollars per troy ounce. tick_time is UTC. Always look at freshness before using a price: fresh means the quote is current; market_closed means it's the last quote before the market closed. Every field, explained.

If it doesn't work

401 unauthorized: the key is missing, mistyped or revoked. Check the X-API-Key header.
402 insufficient_balance: your balance doesn't cover the request. Add funds and try again.
403 with no JSON body: some generic HTTP libraries' default User-Agent is blocked; send your own, e.g. User-Agent: mybot/1.0. The Python client and curl are fine as they are.

Still stuck? Reply to our email or open a support ticket with the error message (remove your API key first).