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+
价格追踪、交互地图与进度工具
赛季
Jaeger21:47
地图
进度
计算器
枪械 / 弹药
更多
Ch
模式
PVP
登录
Ch
模式
 

Tarkov Market API

Escape from Tarkov跳蚤市场价格、商人价格与物品数据。 基础URL： https://api.tarkov-market.app/api/v1

无依赖的官方客户端：Node.js、Python和Go — github.com/ggdiam/tarkov-market-api

示例语言

API密钥

使用API需要网站的 PRO状态 。以下示例使用占位符 your_api_key。

认证

API密钥也允许应用读取和修改你的角色进度。请仅与可信应用共享。需要PRO；生成新API密钥会撤销旧密钥。进度请求仅接受请求头中的x-api-key。

在请求头中传递密钥：

x-api-key: your_api_key

不便使用请求头时（浏览器、直播机器人、电子表格），也可通过查询参数传递：

?x-api-key=your_api_key

密钥缺失、未知或已禁用 → 401 { "error": "Access denied" }

游戏模式

所有物品接口均支持三种游戏模式。可以使用路径前缀或 mode 参数指定模式，两种方式返回相同结果：

模式
路径前缀
参数
价格来源
PVP
/api/v1/…
默认
items集合
PVE
/api/v1/pve/…
mode=pve
PVE扫描
Season
/api/v1/season/…
mode=season
赛季扫描

赛季角色

赛季经济独立扫描，数据仍在积累：只有扫描器在赛季跳蚤市场观察到某物品后，它才有跳蚤价格；avg24hPrice / diff24h会随赛季价格历史积累而填充。不依赖跳蚤市场的字段——basePrice和商人价格——在赛季拥有自己的游戏数据转储前会回退至PVP值。

尚无赛季价格时的示例（相同物品、相同请求，赛季模式）：

{
    "uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
    "name": "LEDX Skin Transilluminator",
    "price": 0,               // 暂无赛季跳蚤价格
    "avg24hPrice": 0,
    "diff24h": 0,
    "updated": "",            // 从未在赛季跳蚤观察到
    "haveMarketData": false,  // 不要使用此物品的price
    "basePrice": 970000,      // 非跳蚤数据，与PVP相同
    "traderName": "Therapist",
    "traderPrice": 494700
}

接口

GET/item?q=ledx
按名称、uid或bsgId查找物品。
q支持任意受支持语言的物品名称或简称。最多返回5项，完全匹配优先
uidTarkov Market物品uid，返回唯一物品
bsgId游戏文件中的物品ID，返回唯一物品
lang名称及网站链接的语言，可选：en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr。默认为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"
响应示例
[
    {
        "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
相同搜索，但使用JSON请求体，适合非拉丁文字查询，无需URL编码。
q / uid / bsgId与GET相同，通过JSON请求体传递
lang与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"}'
响应示例
[
    {
        "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次请求/分钟
以一个数组返回全部物品。数据缓存5分钟，更频繁轮询不会获得新数据。
tags仅保留具有指定标签的物品，逗号分隔：tags=Ammo,Magazines
sort按响应字段排序，例如sort=price
sort_directionasc（默认）或desc
lang名称及网站链接的语言
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"
响应示例
[
    {
        "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次请求/分钟
以可下载JSON文件提供相同的完整列表。
lang名称及网站链接的语言
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"

响应字段

字段
含义
uid
Tarkov Market物品ID，保持稳定，可作为你系统中的键
bsgId
游戏文件中的物品ID
name / shortName
所请求语言的物品名称
tags
物品分类，与网站筛选所用分类相同
price
最近已知的跳蚤价格，单位₽。0表示此模式暂无价格
avg24hPrice / avg7daysPrice
过去24小时 / 7天的跳蚤均价，单位₽
diff24h / diff7days
最新价格相对上述均价的变化，%
basePrice
物品基础（手册）价格，单位₽，用于计算商人收购价
traderName
对此物品出价最高的商人
traderPrice / traderPriceCur
该商人支付的价格，以其使用的货币计（₽、$或€）
traderPriceRub
按游戏内汇率换算为₽的同一商人价格
bannedOnFlea
物品不可在跳蚤市场出售
haveMarketData
物品可在跳蚤交易且价格为近期数据，false表示不应信任price
isFunctional
已从游戏移除或无法获得的物品为false
updated
扫描器最后观察到跳蚤价格的时间，空值表示从未观察到
slots
物品在库存中占用的格数
img / imgBig
网站CDN上的物品图标与大图
icon
img的旧别名，URL相同
link / wikiLink
tarkov-market.com及Wiki上的物品页面

角色进度

进度API基础URL： https://api.tarkov-market.app/api/v1

从/characters获取charUid。角色决定PVP、PVE或SEASON；上方选择器仅用于价格。itemId和questId均为BSG ID，包括别名和目标引用。upgradeKey表示藏身处等级，例如Workbench_2。

GET返回revision和ETag。将示例占位符替换为角色、BSG ID和revision；每次PATCH都发送If-Match: "{revision}"。写入设置绝对值。收到409后读取当前进度并协调修改。重复已应用的值会成功且不会再次写入。

进度：每个密钥和所有者每分钟300次请求；每个所有者每分钟60次PATCH尝试。与价格请求分别计数。429包含Retry-After: 60。私人快照不会缓存。

GET/characters
列出API密钥所有者的角色。
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters"
响应示例
{
    "characters": [
        {
            "charUid": "{charUid}",
            "name": "Main",
            "gameMode": "PVP"
        }
    ]
}
GET/characters/{charUid}/tracked-items
读取名称、图标，以及requiredQuantity（剩余必需数量）、spentQuantity（已计入）、availableQuantity（库存）、remainingQuantity = max(0, requiredQuantity − availableQuantity)和sources。初始物品和已提交步骤会减少需求。可选目标不计入；firInventorySeparate:false表示没有单独的FiR库存。PATCH设置availableQuantity，不能添加或删除自定义目标。 价格：/api/v1/item?bsgId={itemId}&mode={mode}, /api/v1/items/all?mode={mode}. 使用角色的模式(pvp/pve/season)，每格价格按 price / slots 计算。
lang名称及网站链接的语言，可选：en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx。默认为en
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/tracked-items"
响应示例
{
    "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中的绝对值，并在If-Match中发送GET返回的revision。
availableQuantity唯一允许且必填的 JSON 字段：0 至 1,000,000,000 的整数。设置可用库存的绝对值，而不是增加或减少此数量；0 表示清空库存。其他物品字段只读。缺少字段、值无效或含额外字段时返回 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}'
响应示例
{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}
GET/characters/{charUid}/quests
读取适合角色的任务。status计算为completed、failed、unreachable、available或locked，不代表游戏内已接受任务。PATCH使用completed:true或false。重置保留步骤勾选和关联任务的完成状态。
lang名称及网站链接的语言，可选：en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx。默认为en
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/quests"
响应示例
{
    "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中的绝对值，并在If-Match中发送GET返回的revision。
completed唯一允许且必填的 JSON 字段：布尔值。true 完成任务；false 重置完成状态，保留步骤勾选和关联任务的完成状态。此接口不能修改 status、步骤或其他字段。缺少字段、值无效或含额外字段时返回 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}'
响应示例
{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}
GET/characters/{charUid}/hideout
读取藏身处每个等级：upgradeKey、moduleId（BSG ID或null）、completed、prebuilt和canComplete。PATCH使用completed:true或false。先完成前置设施，重置时先重置依赖设施。版本自带的初始设施不能重置。canComplete检查设施依赖，不检查游戏内金钱或技能。
lang名称及网站链接的语言，可选：en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx。默认为en
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/hideout"
响应示例
{
    "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中的绝对值，并在If-Match中发送GET返回的revision。
completed唯一允许且必填的 JSON 字段：布尔值。true 将此升级记录为已建成；false 重置建造状态。其他字段只读。缺少字段、值无效或含额外字段时返回 400 invalid_completed；前置条件或初始设施限制返回 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}'
响应示例
{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

错误：400输入无效；401密钥缺失、禁用、撤销、无所有者或所有者被封禁；403需要PRO或赛季禁用；404角色无法访问或对象未知；409进度冲突、BSG ID歧义或建造限制；413请求体过大；428缺少If-Match；429请求限制；503服务不可用。正文：{"error":"code"}。

notificationDelivered:false表示写入已保存，但网站通知未确认。请刷新进度；这不是写入失败。

限制与错误

规则
详情
300次请求/分钟
每个密钥的所有价格接口共用此限制。进度有独立的请求和写入限制。
5次请求/分钟
适用于各模式完整物品列表及其下载，价格均缓存5分钟。
401
密钥缺失、未知或已禁用。
429
已达到频率限制，响应体会说明触发了哪项限制。

使用条款

API旨在供个人使用。

若用于公开项目，请链接tarkov-market.com并注明其为数据提供方。

若你的公开项目复制了Tarkov Market的大部分功能，访问权限可能在无预警、无补偿的情况下终止。

若转售API，访问权限将被终止，且不作预警或补偿。