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.

Fiyat takibi, etkileşimli haritalar ve ilerleme araçları

Tarkov Market API

Escape from Tarkov için bit pazarı fiyatları, tüccar fiyatları ve eşya verileri. Temel URL: https://api.tarkov-market.app/api/v1

Bağımlılıksız resmî istemciler: Node.js, Python ve Go — github.com/ggdiam/tarkov-market-api

Örnekler:

API anahtarı

API'yi kullanmak için gereken: PRO durumu gereklidir. Aşağıdaki örneklerde kullanılan yer tutucu: your_api_key.

Kimlik doğrulama

API anahtarı uygulamaların karakter ilerlemenizi okumasına ve değiştirmesine de izin verir. Yalnızca güvendiğiniz uygulamalarla paylaşın. PRO gerekir; yeni API anahtarı eskisini iptal eder. İlerleme istekleri x-api-key değerini yalnızca başlıkta kabul eder.

Anahtarınızı bir başlıkta gönderin:

x-api-key: your_api_key

Başlıklar uygun değilse sorgu parametresi olarak gönderin (tarayıcı, yayın botları, e-tablolar):

?x-api-key=your_api_key

Eksik, bilinmeyen veya devre dışı anahtar → 401 { "error": "Access denied" }

Oyun modları

Her eşya uç noktası üç oyun modunda mevcuttur. Mod, yol önekiyle veya şu parametreyle belirlenir: mode — ikisi de aynı yanıtı verir:

Mod

Yol öneki

Parametre

Fiyat kaynağı

PVP

/api/v1/…

varsayılan

items koleksiyonu

PVE

/api/v1/pve/…

mode=pve

PVE taraması

Season

/api/v1/season/…

mode=season

sezon taraması

Sezonluk karakterler

Sezon ekonomisi ayrı taranır ve henüz yenidir: bir eşyanın bit pazarı fiyatı, tarayıcı onu sezon bit pazarında gördükten sonra oluşur. avg24hPrice / diff24h sezon fiyat geçmişi biriktikçe dolar. Bit pazarına bağlı olmayan basePrice ve tüccar fiyatı alanları, sezonun kendi oyun verisi dökümü gelene kadar PVP değerlerini kullanır.

Henüz sezon fiyatı yoksa şöyle görünür (aynı eşya, aynı istek, sezon modu):

{
    "uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
    "name": "LEDX Skin Transilluminator",
    "price": 0,               // henüz sezon bit pazarı fiyatı yok
    "avg24hPrice": 0,
    "diff24h": 0,
    "updated": "",            // sezon bit pazarında hiç görülmedi
    "haveMarketData": false,  // bu eşyanın fiyatını kullanmayın
    "basePrice": 970000,      // bit pazarı verisi değil; PVP ile aynı
    "traderName": "Therapist",
    "traderPrice": 494700
}

Uç noktalar

GET/item?q=ledx

Eşyayı ad, uid veya bsgId ile bulun.

qDesteklenen herhangi bir dilde eşya adı veya kısa adı. En fazla 5 sonuç döndürür; tam eşleşme önce gelir

uidTarkov Market eşya uid'si; tam olarak bir eşya döndürür

bsgIdOyun dosyalarındaki eşya kimliği; tam olarak bir eşya döndürür

langAdların ve site bağlantısının dili. Seçenekler: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Varsayılan 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"

Yanıt örneği

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

Aynı arama, JSON gövdesiyle; Latin dışı sorgularda URL kodlamasına gerek kalmaması için kullanın.

q / uid / bsgIdGET ile aynı; JSON gövdesinde gönderilir

langGET ile aynı

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

Yanıt örneği

[
    {
        "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 istek/dk.

Tüm eşyalar tek dizide. Veriler 5 dakika önbelleğe alınır; daha sık sorgulamak yarar sağlamaz.

tagsYalnızca virgülle ayrılan bu etiketlere sahip eşyaları tut: tags=Ammo,Magazines

sortBir yanıt alanına göre sırala; ör. sort=price

sort_directionasc (varsayılan) veya desc

langAdların ve site bağlantılarının dili

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"

Yanıt örneği

[
    {
        "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 istek/dk.

Aynı tam liste, indirilebilir JSON dosyası olarak.

langAdların ve site bağlantılarının dili

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"

Yanıt alanları

Alan

Anlamı

uid

Tarkov Market eşya kimliği; sabittir, kendi tarafınızda anahtar olarak kullanın

bsgId

Oyun dosyalarındaki eşya kimliği

name / shortName

İstenen dilde eşya adı

Karakter ilerlemesi

İlerleme API temel URL’si: https://api.tarkov-market.app/api/v1

charUid değerini /characters üzerinden alın. Karakter PVP, PVE veya SEASON modunu belirler; üstteki seçim fiyatlar içindir. itemId ve questId, takma kimlikler ve hedef referansları dahil BSG kimlikleridir. upgradeKey, Workbench_2 gibi sığınak seviyesidir.

GET, revision ve ETag döndürür. Örneklerdeki yer tutucuları karakter, BSG kimliği ve revision ile değiştirin; her PATCH için If-Match: "{revision}" gönderin. Mutlak değer ayarlanır. 409 sonrası güncel ilerlemeyi okuyup değişikliği uzlaştırın. Uygulanmış değerin tekrarı yeni yazma olmadan başarılıdır.

İlerleme: anahtar ve sahip başına dakikada 300 istek; sahip başına dakikada 60 PATCH denemesi. Fiyatlardan ayrı limitlerdir. 429, Retry-After: 60 içerir. Özel durumlar önbelleğe alınmaz.

GET/characters

API anahtarı sahibinin karakterlerini listeler.

curl

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

Yanıt örneği

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

GET/characters/{charUid}/tracked-items

Ad ve simgelerle requiredQuantity (kalan zorunlu gereksinim), spentQuantity (hesaba katılan), availableQuantity (stok), remainingQuantity = max(0, requiredQuantity − availableQuantity) ve sources okunur. Başlangıç eşyaları ve teslim edilen adımlar gereksinimi azaltır. İsteğe bağlı hedefler hariçtir; firInventorySeparate:false ayrı FiR stoğu olmadığını belirtir. PATCH availableQuantity ayarlar; özel hedef eklenemez veya silinemez. Fiyatlar: /api/v1/item?bsgId={itemId}&mode={mode}, /api/v1/items/all?mode={mode}. Karakterin modunu (pvp/pve/season) kullanın; yuva başına fiyatı price / slots olarak hesaplayın.

langAdların ve site bağlantısının dili. Seçenekler: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Varsayılan en

curl

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

Yanıt örneği

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

JSON’daki mutlak değeri ayarlayın ve GET revision değerini If-Match ile gönderin.

availableQuantityİzin verilen tek JSON alanıdır ve zorunludur: 0 ile 1.000.000.000 arasında bir tam sayı. Mevcut stoğu bu miktarda değiştirmek yerine mutlak olarak belirler; 0 stoğu sıfırlar. Diğer alanlar salt okunurdur. Eksik, geçersiz veya ek alanlar: 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}'

Yanıt örneği

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

GET/characters/{charUid}/quests

Karaktere uygun görevler okunur. status hesaplanır: completed, failed, unreachable, available veya locked; oyunda görevin kabul edildiği anlamına gelmez. PATCH completed:true veya false. Sıfırlama adım işaretlerini ve bağlantılı görev tamamlanmalarını korur.

langAdların ve site bağlantısının dili. Seçenekler: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Varsayılan en

curl

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

Yanıt örneği

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

JSON’daki mutlak değeri ayarlayın ve GET revision değerini If-Match ile gönderin.

completedİzin verilen tek JSON alanıdır ve zorunludur: bir mantıksal değer. true görevi tamamlar; false adım işaretlerini ve bağlantılı görevlerin tamamlanmasını koruyarak tamamlanmayı sıfırlar. status, adımlar ve diğer alanlar burada değiştirilemez. Eksik, geçersiz veya ek alanlar: 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}'

Yanıt örneği

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

GET/characters/{charUid}/hideout

Her sığınak seviyesi: upgradeKey, moduleId (BSG kimliği veya null), completed, prebuilt, canComplete. PATCH completed:true veya false. Önce ön koşulları tamamlayın, sıfırlamada bağımlıları önce sıfırlayın. Sürümün başlangıç yapıları sıfırlanamaz. canComplete yalnızca modül bağımlılıklarını denetler, oyun içi para veya becerileri değil.

langAdların ve site bağlantısının dili. Seçenekler: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Varsayılan en

curl

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

Yanıt örneği

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

JSON’daki mutlak değeri ayarlayın ve GET revision değerini If-Match ile gönderin.

completedİzin verilen tek JSON alanıdır ve zorunludur: bir mantıksal değer. true bu yükseltmeyi inşa edilmiş olarak kaydeder; false inşayı sıfırlar. Diğer alanlar salt okunurdur. Eksik, geçersiz veya ek alanlar: 400 invalid_completed; bağımlılık veya başlangıç yapısı kısıtlamaları: 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}'

Yanıt örneği

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

Hatalar: 400 geçersiz girdi; 401 eksik, devre dışı, iptal edilmiş, sahipsiz anahtar veya yasaklı sahip; 403 PRO gerekli veya sezon kapalı; 404 erişilemeyen karakter/bilinmeyen varlık; 409 ilerleme çakışması, belirsiz BSG kimliği veya yapı kısıtları; 413 büyük gövde; 428 If-Match eksik; 429 limit; 503 servis kullanılamıyor. Gövde: {"error":"code"}.

notificationDelivered:false, yazmanın kaydedildiğini ancak site bildiriminin doğrulanmadığını belirtir. İlerlemeyi yenileyin; yazma başarısız olmamıştır.

Sınırlar ve hatalar

Kural

Ayrıntılar

300 istek/dk.

Anahtar başına tüm fiyat uç noktaları için. İlerleme için ayrı istek ve yazma limitleri vardır.

5 istek/dk.

Her modda tam eşya listesi ve indirmesi. Fiyatlar zaten 5 dakika önbellekte tutulur.

401

Anahtar eksik, bilinmiyor veya devre dışı.

429

İstek sınırına ulaşıldı; gövde hangi sınır olduğunu belirtir.

Koşullar

API, kişisel kullanım için tasarlanmıştır.

Herkese açık bir projede kullanıyorsanız lütfen veri sağlayıcısı olarak tarkov-market.com'a bağlantı verin.

Herkese açık projeniz Tarkov Market özelliklerinin çoğunu kopyalarsa erişiminiz uyarı ve tazminat olmadan sonlandırılabilir.

API'yi yeniden satarsanız erişiminiz uyarı ve tazminat olmadan sonlandırılır.