Tarkov Pilot
⬤
Tarkov Pilot v2 released — old versions don't work anymore, please download the new one. Easier setup, auto-update, all settings in the app window.
Tarkov Market18+
Sledovanie cien, interaktívne mapy a nástroje postupu
Sezóny
Jaeger21:47
Mapy
Postup
Kalkulačky
Zbrane/Munícia
Viac
Sk
Režim
PVP
Prihlásiť sa
Sk
Režim
 

Tarkov Market API

Ceny na blšom trhu, ceny obchodníkov a údaje predmetov pre Escape from Tarkov. Základná URL: https://api.tarkov-market.app/api/v1

Oficiálni klienti bez závislostí: Node.js, Python a Go – github.com/ggdiam/tarkov-market-api

Príklady pre

Kľúč API

Na používanie API potrebuješ status Pro na webe. Príklady nižšie používajú zástupnú hodnotu your_api_key.

Autentifikácia

Kľúč API umožňuje aplikáciám aj čítať a meniť postup vašich postáv. Zdieľajte ho len s dôveryhodnými aplikáciami. Potrebujete PRO; nový kľúč API zruší starý. Postup prijíma x-api-key iba v hlavičke.

Kľúč odovzdaj v hlavičke:

x-api-key: your_api_key

Alebo ako parameter požiadavky, ak sú hlavičky nepraktické (prehliadač, streamovacie boty, tabuľky):

?x-api-key=your_api_key

Chýbajúci, neznámy alebo vypnutý kľúč → 401 { "error": "Access denied" }

Herné režimy

Každý koncový bod predmetov existuje v troch herných režimoch. Režim možno nastaviť prefixom cesty alebo parametrom mode – obe možnosti vrátia rovnakú odpoveď:

Režim
Prefix cesty
Parameter
Zdroj cien
PVP
/api/v1/…
predvolený
kolekcia predmetov
PVE
/api/v1/pve/…
mode=pve
sken PVE
Season
/api/v1/season/…
mode=season
sezónny sken

Sezónne postavy

Sezónna ekonomika sa skenuje samostatne a je mladá: predmet má cenu na trhu až po tom, čo ho skener uvidí na sezónnom trhu, a avg24hPrice / diff24h sa dopĺňajú s históriou sezónnych cien. Polia nezávislé od trhu – basePrice a cena obchodníka – používajú hodnoty PVP, kým sezóna nedostane vlastný výpis herných dát.

Chýbajúca sezónna cena vyzerá takto (rovnaký predmet, rovnaká požiadavka, sezónny režim):

{
    "uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
    "name": "LEDX Skin Transilluminator",
    "price": 0,               // zatiaľ bez sezónnej ceny na trhu
    "avg24hPrice": 0,
    "diff24h": 0,
    "updated": "",            // na sezónnom trhu ešte nezaznamenané
    "haveMarketData": false,  // pri tomto predmete nepoužívaj cenu
    "basePrice": 970000,      // nejde o údaje trhu – rovnaké ako PVP
    "traderName": "Therapist",
    "traderPrice": 494700
}

Koncové body

GET/item?q=ledx
Nájdi predmet podľa názvu, uid alebo bsgId.
qNázov alebo skrátený názov predmetu v ľubovoľnej podporovanej lokalizácii. Vráti najviac 5 zhôd, presnú zhodu ako prvú
uiduid predmetu Tarkov Market – vráti presne jeden predmet
bsgIdID predmetu z herných súborov – vráti presne jeden predmet
langJazyk názvov a odkazu na web. Jeden z: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Predvolene en
URL
https://api.tarkov-market.app/api/v1/item?q=ledx&x-api-key=your_api_key
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/item?q=ledx"
Príklad odpovede
[
    {
        "uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
        "name": "LEDX Skin Transilluminator",
        "bannedOnFlea": false,
        "haveMarketData": true,
        "tags": ["Barter"],
        "shortName": "LEDX",
        "price": 550000,
        "basePrice": 970000,
        "avg24hPrice": 598993,
        "avg7daysPrice": 671670,
        "traderName": "Therapist",
        "traderPrice": 494700,
        "traderPriceCur": "₽",
        "traderPriceRub": 494700,
        "updated": "2026-08-05T17:34:28.319Z",
        "slots": 1,
        "diff24h": -8.18,
        "diff7days": -18.11,
        "icon": "https://cdn.tarkov-market.app/images/items/a7f7568c-61fb-437e-9f71-06e58aae26ba_sm.png",
        "link": "https://tarkov-market.com/item/ledx_skin_transilluminator",
        "wikiLink": "https://escapefromtarkov.fandom.com/wiki/LEDX_Skin_Transilluminator",
        "img": "https://cdn.tarkov-market.app/images/items/a7f7568c-61fb-437e-9f71-06e58aae26ba_sm.png",
        "imgBig": "https://cdn.tarkov-market.app/images/items/ledx_skin_transilluminator_lg.png",
        "bsgId": "5c0530ee86f774697952d952",
        "isFunctional": true,
        "reference": "https://www.patreon.com/tarkov_market"
    }
]
POST/item
Rovnaké vyhľadávanie, ale s telom JSON – vhodné pre požiadavky mimo latinky, aby nebolo nutné kódovanie URL.
q / uid / bsgIdRovnaké ako v GET, odovzdané v tele JSON
langRovnaké ako v GET
curl
curl https://api.tarkov-market.app/api/v1/item \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -X POST --data '{"q":"AI-2急救组合","lang":"ch"}'
Príklad odpovede
[
    {
        "uid": "2335b619-c562-41da-962f-e7b5aba5d45c",
        "name": "AI-2急救组合",
        "shortName": "AI-2",
        "tags": ["Meds"],
        "price": 6900,
        "basePrice": 4160,
        "avg24hPrice": 6695,
        "avg7daysPrice": 5912,
        "traderName": "Therapist",
        "traderPrice": 2121,
        "traderPriceCur": "₽",
        "traderPriceRub": 2121,
        "diff24h": 3.06,
        "diff7days": 16.71,
        "updated": "2026-08-05T17:07:42.165Z",
        "link": "https://tarkov-market.com/ch/item/ai-2_medikit",
        "bsgId": "5755356824597772cb798962",
        "isFunctional": true
    }
]
GET/items/all5 pož./min
Všetky predmety v jednom poli. Údaje sa ukladajú do vyrovnávacej pamäte na 5 minút, častejšie požiadavky preto nič neprinesú.
tagsPonechať iba predmety s týmito štítkami oddelenými čiarkou: tags=Ammo,Magazines
sortZoradiť podľa poľa odpovede, napríklad sort=price
sort_directionasc (predvolené) alebo desc
langJazyk názvov a odkazov na web
URL
https://api.tarkov-market.app/api/v1/items/all?x-api-key=your_api_key
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/items/all"
Príklad odpovede
[
    {
        "uid": "f0fa8457-6638-4ad2-b7e8-4708033d8f39",
        "name": "Secure Flash drive",
        "shortName": "Flash drive",
        "price": 37400,
        ...
    },
    {
        "uid": "33c15349-44e6-4553-9705-1b6417a1ad6a",
        "name": "SSD drive",
        ...
    },
    ...
]
GET/items/all/download5 pož./min
Rovnaký úplný zoznam ako súbor JSON na stiahnutie.
langJazyk názvov a odkazov na web
URL
https://api.tarkov-market.app/api/v1/items/all/download?x-api-key=your_api_key
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/items/all/download"

Polia odpovede

Pole
Význam
uid
ID predmetu Tarkov Market – stabilné, na svojej strane ho používaj ako kľúč
bsgId
ID predmetu z herných súborov
name / shortName
Názov predmetu v požadovanom jazyku
tags
Kategórie predmetu, rovnaké ako filtre webu
price
Posledná známa cena na trhu, ₽. 0 znamená, že pre tento režim cena chýba
avg24hPrice / avg7daysPrice
Priemerná cena na trhu za posledných 24 hodín / 7 dní, ₽
diff24h / diff7days
Zmena poslednej ceny oproti týmto priemerom, %
basePrice
Základná cena predmetu z príručky, ₽ – z nej sa počíta výkup u obchodníka
traderName
Obchodník, ktorý za predmet platí najviac
traderPrice / traderPriceCur
Koľko tento obchodník platí vo svojej mene (₽, $ alebo €)
traderPriceRub
Rovnaká cena obchodníka prepočítaná na ₽ herným kurzom
bannedOnFlea
Predmet nemožno predať na blšom trhu
haveMarketData
Predmet je obchodovateľný na trhu a cena je čerstvá – false znamená, že cene nemožno dôverovať
isFunctional
false pri predmetoch odstránených z hry alebo nedostupných
updated
Kedy skener naposledy zaznamenal cenu na trhu. Prázdne znamená nikdy
slots
Veľkosť predmetu v inventári v políčkach
img / imgBig
Ikona a veľký obrázok predmetu na mojom CDN
icon
Starší alias poľa img – rovnaká URL
link / wikiLink
Stránka predmetu na tarkov-market.com a wiki

Postup postavy

Základná URL API postupu: https://api.tarkov-market.app/api/v1

Získajte charUid z /characters. Postava určuje PVP, PVE alebo SEASON; výber hore platí pre ceny. itemId a questId sú BSG ID vrátane aliasov a odkazov cieľov. upgradeKey označuje úroveň úkrytu, napr. Workbench_2.

GET vracia revision a ETag. Nahraďte zástupné hodnoty postavou, BSG ID a revision; v každom PATCH pošlite If-Match: "{revision}". Zápis nastavuje absolútne hodnoty. Po 409 načítajte aktuálny postup a zosúlaďte zmenu. Opakovanie použitej hodnoty uspeje bez ďalšieho zápisu.

Postup: 300 požiadaviek/minútu na kľúč a vlastníka; 60 pokusov PATCH/minútu na vlastníka. Limity oddelené od cien. 429 obsahuje Retry-After: 60. Súkromné stavy sa neukladajú do cache.

GET/characters
Zoznam postáv vlastníka kľúča API.
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters"
Príklad odpovede
{
    "characters": [
        {
            "charUid": "{charUid}",
            "name": "Main",
            "gameMode": "PVP"
        }
    ]
}
GET/characters/{charUid}/tracked-items
Názvy a ikony s requiredQuantity (zostávajúce povinné požiadavky), spentQuantity (už započítané), availableQuantity (zásoba), remainingQuantity = max(0, requiredQuantity − availableQuantity) a sources. Počiatočné predmety a odovzdané kroky znižujú potrebu. Voliteľné ciele sú vynechané; firInventorySeparate:false znamená, že nie je samostatná zásoba FiR. PATCH nastavuje availableQuantity; vlastné ciele nemožno pridať ani vymazať. Ceny: /api/v1/item?bsgId={itemId}&mode={mode}, /api/v1/items/all?mode={mode}. Použite režim postavy (pvp/pve/season); cenu za slot vypočítajte ako price / slots.
langJazyk názvov a odkazu na web. Jeden z: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Predvolene en
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/tracked-items"
Príklad odpovede
{
    "charUid": "{charUid}",
    "gameMode": "PVP",
    "revision": "{revision}",
    "firInventorySeparate": false,
    "items": [
        {
            "itemId": "5c0530ee86f774697952d952",
            "name": "LEDX Skin Transilluminator",
            "shortName": "LEDX",
            "slots": 1,
            "icon": "https://cdn.tarkov-market.app/images/items/a7f7568c-61fb-437e-9f71-06e58aae26ba_sm.png",
            "requiredQuantity": 10,
            "spentQuantity": 0,
            "availableQuantity": 5,
            "remainingQuantity": 5,
            "sources": [
                {
                    "type": "quest",
                    "questId": "{BSG quest ID}",
                    "amount": 10,
                    "remainingRequiredQuantity": 10,
                    "fir": true,
                    "completed": false,
                    "canceled": false
                }
            ]
        }
    ]
}
PATCH/characters/{charUid}/tracked-items/{itemId}
Nastavte absolútnu hodnotu JSON a pošlite revision z GET v If-Match.
availableQuantityJediné povolené pole JSON, povinné: celé číslo od 0 do 1 000 000 000. Nastaví absolútnu dostupnú zásobu, namiesto zmeny o túto hodnotu; 0 zásobu vynuluje. Ostatné polia sú len na čítanie. Chýbajúce, neplatné alebo ďalšie polia: 400 invalid_quantity.
curl
curl "https://api.tarkov-market.app/api/v1/characters/{charUid}/tracked-items/{itemId}" \
  -H "x-api-key: your_api_key" \
  -H 'If-Match: "{revision}"' \
  -H "Content-Type: application/json" \
  -X PATCH --data '{"availableQuantity":4}'
Príklad odpovede
{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}
GET/characters/{charUid}/quests
Úlohy vhodné pre postavu. status sa vypočíta: completed, failed, unreachable, available alebo locked; neznamená prijatie v hre. PATCH completed:true alebo false. Reset zachová zaškrtnuté kroky a dokončenie prepojených úloh.
langJazyk názvov a odkazu na web. Jeden z: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Predvolene en
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/quests"
Príklad odpovede
{
    "charUid": "{charUid}",
    "gameMode": "PVP",
    "revision": "{revision}",
    "quests": [
        {
            "questId": "{BSG quest ID}",
            "questIdAliases": [],
            "name": "Quest name",
            "trader": "Therapist",
            "completed": false,
            "status": "available"
        }
    ]
}
PATCH/characters/{charUid}/quests/{questId}
Nastavte absolútnu hodnotu JSON a pošlite revision z GET v If-Match.
completedJediné povolené pole JSON, povinné: logická hodnota. true dokončí úlohu; false resetuje dokončenie so zachovaním označených krokov a dokončených prepojených úloh. status, kroky ani iné polia tu nemožno meniť. Chýbajúce, neplatné alebo ďalšie polia: 400 invalid_completed.
curl
curl "https://api.tarkov-market.app/api/v1/characters/{charUid}/quests/{questId}" \
  -H "x-api-key: your_api_key" \
  -H 'If-Match: "{revision}"' \
  -H "Content-Type: application/json" \
  -X PATCH --data '{"completed":true}'
Príklad odpovede
{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}
GET/characters/{charUid}/hideout
Každá úroveň úkrytu: upgradeKey, moduleId (BSG ID alebo null), completed, prebuilt a canComplete. PATCH completed:true alebo false. Najprv dokončite predpoklady, najprv resetujte závislé stavby. Počiatočné stavby edície nemožno resetovať. canComplete kontroluje moduly, nie peniaze alebo schopnosti v hre.
langJazyk názvov a odkazu na web. Jeden z: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Predvolene en
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/hideout"
Príklad odpovede
{
    "charUid": "{charUid}",
    "gameMode": "PVP",
    "revision": "{revision}",
    "modules": [
        {
            "upgradeKey": "Workbench_2",
            "moduleId": "{BSG module ID}",
            "name": "Workbench",
            "level": 2,
            "completed": false,
            "prebuilt": false,
            "canComplete": true
        }
    ]
}
PATCH/characters/{charUid}/hideout/{upgradeKey}
Nastavte absolútnu hodnotu JSON a pošlite revision z GET v If-Match.
completedJediné povolené pole JSON, povinné: logická hodnota. true označí toto vylepšenie ako postavené; false stavbu resetuje. Ostatné polia sú len na čítanie. Chýbajúce, neplatné alebo ďalšie polia: 400 invalid_completed; obmedzenia závislostí alebo počiatočných stavieb: 409.
curl
curl "https://api.tarkov-market.app/api/v1/characters/{charUid}/hideout/{upgradeKey}" \
  -H "x-api-key: your_api_key" \
  -H 'If-Match: "{revision}"' \
  -H "Content-Type: application/json" \
  -X PATCH --data '{"completed":true}'
Príklad odpovede
{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

Chyby: 400 neplatné údaje; 401 chýbajúci, vypnutý, zrušený kľúč, kľúč bez vlastníka alebo zablokovaný vlastník; 403 treba PRO/sezóna vypnutá; 404 nedostupná postava/neznámy objekt; 409 konflikt, nejednoznačné BSG ID alebo obmedzenia stavby; 413 veľké telo; 428 chýba If-Match; 429 limit; 503 služba nedostupná. Telo: {"error":"code"}.

notificationDelivered:false znamená uložený zápis bez potvrdenia oznámenia webu. Obnovte postup; zápis nezlyhal.

Limity a chyby

Pravidlo
Podrobnosti
300 pož./min
Na kľúč, pre všetky cenové endpointy. Postup má oddelené limity požiadaviek a zápisov.
5 pož./min
Úplný zoznam predmetov a jeho stiahnutie vo všetkých režimoch. Ceny sú aj tak uložené vo vyrovnávacej pamäti na 5 minút.
401
Kľúč chýba, je neznámy alebo vypnutý.
429
Dosiahnutý limit požiadaviek – telo odpovede uvádza, ktorý limit.

Podmienky

API je určené na osobné použitie.

Pri použití vo verejnom projekte uveď odkaz na tarkov-market.com ako poskytovateľa údajov.

Ak verejný projekt kopíruje väčšinu funkcií tarkov-market, prístup môže byť ukončený bez upozornenia a náhrady.

Pri ďalšom predaji API bude prístup ukončený bez upozornenia a náhrady.