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.

Árkövető, interaktív térképek és haladást segítő eszközök

Tarkov Market API

Bolhapiaci árak, kereskedői árak és tárgyadatok az Escape from Tarkovhoz. Alap-URL: https://api.tarkov-market.app/api/v1

Hivatalos kliensek függőségek nélkül: Node.js, Python és Go – github.com/ggdiam/tarkov-market-api

Példák ehhez

API-kulcs

Az API használatához szükséges Pro státusz az oldalon. Az alábbi példák ezt a helyőrzőt használják: your_api_key.

Hitelesítés

Az API-kulcs az alkalmazásoknak a karaktereid haladásának olvasását és módosítását is engedélyezi. Csak megbízható alkalmazásokkal oszd meg. PRO szükséges; új API-kulcs létrehozása visszavonja a régit. A haladás csak fejlécben fogadja az x-api-key értéket.

Add át a kulcsodat fejlécben:

x-api-key: your_api_key

Vagy lekérdezési paraméterként, ha a fejléc kényelmetlen (böngésző, streambotok, táblázatok):

?x-api-key=your_api_key

Hiányzó, ismeretlen vagy letiltott kulcs → 401 { "error": "Access denied" }

Játékmódok

Minden tárgyvégpont három játékmódban létezik. A mód útvonal-előtaggal vagy ezzel a paraméterrel állítható: mode – mindkettő ugyanazt a választ adja:

Mód

Útvonal-előtag

Paraméter

Árak forrása

PVP

/api/v1/…

alapértelmezett

tárgygyűjtemény

PVE

/api/v1/pve/…

mode=pve

PVE-szkennelés

Season

/api/v1/season/…

mode=season

szezonális szkennelés

Szezonális karakterek

A szezonális gazdaságot külön szkennelem, és még fiatal: egy tárgynak csak akkor van bolhapiaci ára, ha a szkenner látta a szezonális bolhapiacon, az avg24hPrice / diff24h pedig az árelőzmények gyűlésével töltődik. A bolhapiactól független mezők – basePrice és kereskedői ár – PVP-értékeket használnak, amíg a szezon saját játékadat-dumpot nem kap.

Így néz ki, ha még nincs szezonális ár (ugyanaz a tárgy és kérés, szezonális módban):

{
    "uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
    "name": "LEDX Skin Transilluminator",
    "price": 0,               // még nincs szezonális bolhapiaci ár
    "avg24hPrice": 0,
    "diff24h": 0,
    "updated": "",            // még nem látta a szezonális bolhapiacon
    "haveMarketData": false,  // ne használd e tárgy árát
    "basePrice": 970000,      // nem bolhapiaci adat – megegyezik a PVP-vel
    "traderName": "Therapist",
    "traderPrice": 494700
}

Végpontok

GET/item?q=ledx

Tárgy keresése név, uid vagy bsgId alapján.

qTárgynév vagy rövid név bármely támogatott nyelven. Legfeljebb 5 találatot ad, pontos egyezéssel elöl

uidTarkov Market tárgy-uid – pontosan egy tárgyat ad vissza

bsgIdTárgyazonosító a játékfájlokból – pontosan egy tárgyat ad vissza

langA nevek és a weboldalhivatkozás nyelve. Ezek egyike: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Alapértelmezett: 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"

Példaválasz

[
    {
        "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

Ugyanaz a keresés JSON-törzzsel – nem latin betűs keresésekhez, hogy ne kelljen URL-kódolni.

q / uid / bsgIdUgyanaz, mint GET-ben, a JSON-törzsben átadva

langUgyanaz, mint GET-ben

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"}'

Példaválasz

[
    {
        "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 kérés/perc

Minden tárgy egy tömbben. Az adatok 5 percig gyorsítótárazva vannak, gyakoribb lekérdezésnek nincs haszna.

tagsCsak e címkékkel rendelkező tárgyak, vesszővel elválasztva: tags=Ammo,Magazines

sortRendezés válaszmező szerint, például sort=price

sort_directionasc (alapértelmezett) vagy desc

langA nevek és weboldalhivatkozások nyelve

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"

Példaválasz

[
    {
        "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 kérés/perc

Ugyanaz a teljes lista letölthető JSON-fájlként.

langA nevek és weboldalhivatkozások nyelve

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"

Válaszmezők

Mező

Jelentés

uid

Tarkov Market tárgyazonosító – stabil, ezt használd kulcsként saját rendszeredben

bsgId

Tárgyazonosító a játékfájlokból

name / shortName

Tárgynév a kért nyelven

Karakter haladása

A haladási API alap-URL-je: https://api.tarkov-market.app/api/v1

A charUid értékét a /characters adja. A karakter határozza meg a PVP, PVE vagy SEASON módot; a fenti választó az árakra vonatkozik. Az itemId és questId BSG-azonosítók, az aliasok és célhivatkozások is. Az upgradeKey egy rejtekhelyszint, például Workbench_2.

A GET revision és ETag értéket ad. Cseréld a helyőrzőket karakterre, BSG-azonosítóra és revision értékre; minden PATCH küldjön If-Match: "{revision}" fejlécet. Abszolút értéket állít. 409 után olvasd a friss haladást, és egyeztesd a változást. Egy alkalmazott érték ismétlése új írás nélkül sikeres.

Haladás: 300 kérés/perc kulcsonként és tulajdonosonként; 60 PATCH-kísérlet/perc tulajdonosonként. Az áraktól külön keret. A 429 tartalmazza: Retry-After: 60. A személyes állapot nincs gyorsítótárazva.

GET/characters

Az API-kulcs tulajdonosának karakterlistája.

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters"

Példaválasz

{
    "characters": [
        {
            "charUid": "{charUid}",
            "name": "Main",
            "gameMode": "PVP"
        }
    ]
}

GET/characters/{charUid}/tracked-items

Nevek, ikonok és requiredQuantity (hátralévő kötelező igény), spentQuantity (már elszámolt), availableQuantity (készlet), remainingQuantity = max(0, requiredQuantity − availableQuantity), sources. A kezdő tárgyak és leadott lépések csökkentik az igényt. Opcionális célok nélkül; a firInventorySeparate:false külön FiR-készlet hiányát jelenti. A PATCH availableQuantity értéket állít; egyéni célt nem lehet hozzáadni vagy törölni. Árak: /api/v1/item?bsgId={itemId}&mode={mode}, /api/v1/items/all?mode={mode}. A karakter módját (pvp/pve/season) használd; az egy helyre jutó árat price / slots képlettel számold ki.

langA nevek és a weboldalhivatkozás nyelve. Ezek egyike: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Alapértelmezett: en

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/tracked-items"

Példaválasz

{
    "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}

Állítsd a JSON abszolút értékét, és küldd a GET revision értékét If-Match fejlécként.

availableQuantityAz egyetlen megengedett JSON-mező, kötelező: egész szám 0 és 1 000 000 000 között. A rendelkezésre álló készlet abszolút értékét állítja be, nem ennyivel módosítja; 0 lenullázza a készletet. A többi mező csak olvasható. Hiányzó, érvénytelen vagy további mezők: 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}'

Példaválasz

{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

GET/characters/{charUid}/quests

A karakterhez illő küldetések. A status számított: completed, failed, unreachable, available vagy locked; nem jelenti a játékbeli felvételt. PATCH completed:true vagy false. A visszaállítás megőrzi a lépések jelölését és a kapcsolt küldetések teljesítését.

langA nevek és a weboldalhivatkozás nyelve. Ezek egyike: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Alapértelmezett: en

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/quests"

Példaválasz

{
    "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}

Állítsd a JSON abszolút értékét, és küldd a GET revision értékét If-Match fejlécként.

completedAz egyetlen megengedett JSON-mező, kötelező: logikai érték. true befejezi a küldetést; false visszaállítja a befejezést, megtartva a megjelölt lépéseket és a kapcsolódó küldetések befejezését. A status, a lépések és más mezők itt nem módosíthatók. Hiányzó, érvénytelen vagy további mezők: 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}'

Példaválasz

{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

GET/characters/{charUid}/hideout

Minden rejtekhelyszint: upgradeKey, moduleId (BSG-azonosító vagy null), completed, prebuilt, canComplete. PATCH completed:true vagy false. Előbb az előfeltételeket teljesítsd, visszaállításnál előbb a függő építményeket. A kiadás kezdő építményei nem állíthatók vissza. A canComplete a modulfüggőségeket vizsgálja, nem a játékbeli pénzt vagy képességeket.

langA nevek és a weboldalhivatkozás nyelve. Ezek egyike: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Alapértelmezett: en

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/hideout"

Példaválasz

{
    "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}

Állítsd a JSON abszolút értékét, és küldd a GET revision értékét If-Match fejlécként.

completedAz egyetlen megengedett JSON-mező, kötelező: logikai érték. true megépítettként rögzíti ezt a fejlesztést; false visszaállítja az építést. A többi mező csak olvasható. Hiányzó, érvénytelen vagy további mezők: 400 invalid_completed; függőségi vagy kezdő építménykorlátozás: 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}'

Példaválasz

{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

Hibák: 400 hibás adat; 401 hiányzó, kikapcsolt, visszavont vagy tulajdonos nélküli kulcs, illetve tiltott tulajdonos; 403 PRO szükséges/szezon kikapcsolva; 404 elérhetetlen karakter/ismeretlen elem; 409 ütközés, többértelmű BSG-azonosító vagy építési korlát; 413 túl nagy törzs; 428 hiányzó If-Match; 429 korlát; 503 szolgáltatás nem elérhető. Törzs: {"error":"code"}.

A notificationDelivered:false mentett írást jelent, megerősített webhelyértesítés nélkül. Frissítsd a haladást; az írás nem sikertelen.

Korlátok és hibák

Szabály

Részletek

300 kérés/perc

Kulcsonként, az összes árvégponton. A haladás külön kérési és írási kerettel rendelkezik.

5 kérés/perc

Teljes tárgylista és letöltése minden módban. Az árak egyébként is 5 percig gyorsítótárazva vannak.

401

Hiányzó, ismeretlen vagy letiltott kulcs.

429

Kéréskorlát elérve – a válasz törzse megadja, melyik korlát.

Feltételek

Az API személyes használatra készült.

Nyilvános projektben való használatkor hivatkozz a tarkov-market.com-ra adatforrásként.

Ha nyilvános projekted lemásolja a tarkov-market funkcióinak nagy részét, hozzáférésed előzetes figyelmeztetés és kártérítés nélkül megszüntethető.

Ha továbbértékesíted az API-t, hozzáférésed figyelmeztetés és kártérítés nélkül megszűnik.