Tarkov Market Backend API

Overview

The Tarkov Market backend exposes a small JSON-over-HTTPS interface for querying current and historical item prices on the Escape from Tarkov flea market. Responses are cached at the edge for 30–60 seconds and served from the closest of three regional nodes (DE, RU, US-East).

The API is intentionally minimal — most consumers only need the /items endpoint and a small number of filters. For higher-throughput workloads (overlays, hideout planners, trade bots) we recommend the websocket price stream described below.

Base URL

backend.tarkov-market.ru

Items tracked

2,847

Updates / hour

~41,000

Median latency

38 ms

Authentication

All requests must include an API key in the x-api-key header. Free keys are issued through the developer dashboard and allow up to 300 requests per minute. Partner keys (issued on request) raise the limit to 6,000 r/m and unlock the websocket price stream.

# request
curl https://backend.tarkov-market.ru/api/v3/items \
  -H "x-api-key: 7f3a90c2e1b94f8a91b1a5c6e91c" \
  -H "accept: application/json"

Keys are scoped per-domain. Calls from the wrong Origin are rejected with 403 Forbidden regardless of the key validity. CORS is enabled for the domains listed in the dashboard.

Endpoints

GET /api/v3/items cached 60s

Returns the full list of tradable items with current flea market prices, 24-hour change and last-seen timestamp. Roughly 2.4 MB uncompressed, ~310 KB on the wire.

Parameter	Type	Description
lang	string	Localization (`en`, `ru`, `de`, `fr`, `es`, `cn`). Defaults to `en`.
type	string	Filter by item category (`weapon`, `armor`, `ammo`, `barter`, …).
since	int	Unix timestamp; only items updated after this point are returned.

// 200 OK
[
  {
    "uid": "5710c24d86f7743cb83d3e9e",
    "name": "Physical Bitcoin",
    "shortName": "BTC",
    "price": 541203,
    "basePrice": 100000,
    "avg24hPrice": 538440,
    "avg7daysPrice": 529112,
    "diff24h": 0.51,
    "trader": "Therapist",
    "traderPrice": 79000,
    "traderPriceCur": "₽",
    "updated": "2026-04-10T17:42:11Z",
    "slots": 1,
    "tags": ["barter", "hideout"]
  },
  ...
]

GET /api/v3/item/{uid} cached 30s

Returns detailed information about a single item, including the price history, barter trades, quest usage and the list of traders that buy or sell it.

Parameter	Type	Description
uidrequired	string	BSG item identifier (24-char hex).
history	int	Number of historical price points to return (max 720, one per hour).
lang	string	Localization. Defaults to `en`.

GET /api/v3/traders cached 5m

Lists all in-game traders with their current loyalty unlocks, reset timers and currency. Useful for hideout planners and barter calculators.

GET /api/v3/bsg/{lang} cached 1h

Mirrors the official BSG item dictionary, normalized to UTF-8 with stripped HTML markup. Refreshed on every patch deployment, never more than once per hour.

WS wss://backend.tarkov-market.ru/ws partner only

Push channel that emits a delta message every time a tracked price moves more than 1.5%. Average payload is ~120 bytes; expect 3–8 messages per second during prime EU evenings.

// frame
{ "t": "px", "uid": "5448bf274bdc2dfc2f8b456a", "p": 112400, "d": -2.1 }

Rate limits

Free keys are limited to 300 requests / minute per IP. Partner keys raise this to 6,000 r/m and remove the per-IP cap. Each response includes an x-ratelimit-remaining header; when the budget is exhausted the server replies with 429 Too Many Requests and a retry-after hint in seconds.

Bursts up to 2× the limit are tolerated for short windows. Sustained abuse will get the key revoked — please cache aggressively on your end if you only need slow-changing data.

Errors

Code	Meaning	Notes
400	Bad Request	Malformed query string or unknown parameter.
401	Unauthorized	Missing or invalid `x-api-key`.
403	Forbidden	Origin not allowed for this key.
404	Not Found	Item uid or trader does not exist.
429	Too Many Requests	Rate limit exceeded — see `retry-after`.
503	Service Unavailable	Upstream BSG outage; cached data may be stale.

Changelog

v3.4.1 — 2026-03-22 · Updated item metadata for patch 0.16.5, added tags field to item payload, fixed CN localization fallback.

v3.4.0 — 2026-02-10 · New /ws websocket stream for partner keys; /items response is now gzip + brotli on the wire.

v3.3.0 — 2025-12-08 · Localization endpoint redesign, added Chinese translations, retired the legacy /api/items.json route.

v3.2.5 — 2025-10-14 · Three new traders supported (post-Arena merge), trader loyalty unlocks exposed.

Status

Live status, regional latency and incident history are published at status.tarkov-market.com. Push notifications are available through the same channel.