### GET /v1/items/{slug}/statistics Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get trading statistics for an item. Returns historical price and volume statistics for the specified item, including both completed trades and live order data. ## Data Timeframes - **48hours**: Hourly data points for the last 48 hours - **90days**: Daily data points for the last 90 days ## Statistics Types - **statistics_closed**: Data from completed trades - **statistics_live**: Data from live/pending orders ## Price Indicators Each data point includes OHLC-style pricing (open, high, low, close), various averages (simple, weighted, moving), and Donchian channel bounds. ```markdown ### Parameters - **slug** (string, path, required): Item URL slug (e.g., 'sicarus_prime_receiver') ### Responses #### 200 - The request has succeeded. - **payload** (object) (required): Complete item trading statistics. - **statistics_closed** (object) (required): Statistics grouped by timeframe. - **48hours** (array (Models.StatisticEntry)) (required): Hourly data points for the last 48 hours Array items: - **id** (string) (required): Unique identifier - **datetime** (string (date-time)) (required): Timestamp for this data point (hourly for 48hours, daily for 90days) - **volume** (integer (int32)) (required): Number of trades in this period - **min_price** (integer (int32)) (required): Lowest price in this period - **max_price** (integer (int32)) (required): Highest price in this period - **open_price** (integer (int32)) (required): First trade price in this period - **closed_price** (integer (int32)) (required): Last trade price in this period - **avg_price** (number (double)) (required): Simple average price - **wa_price** (number (double)) (required): Volume-weighted average price - **median** (number (double)) (required): Median price - **moving_avg** (number (double)) (required): Moving average price - **donch_top** (integer (int32)) (required): Donchian channel top (highest high over lookback period) - **donch_bot** (integer (int32)) (required): Donchian channel bottom (lowest low over lookback period) - **90days** (array (Models.StatisticEntry)) (required): Daily data points for the last 90 days Array items: - **statistics_live** (object) (required): Statistics grouped by timeframe. #### 404 - 404 Not Found - Resource does not exist. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name ### Example Usage ```bash curl -X GET "https://api.warframe.market/v1/items/{slug}/statistics" ``` ``` -------------------------------- ### POST /v1/auth/signin Source: https://kibbewater.github.io/wfm-openapi/openapi.json Sign in with username and password. Authenticates a user and returns a JWT token in the response header. ## Important Notes - The `Authorization: JWT` header is required in the request - On success, the JWT token is returned in the `Authorization` response header - The token is prefixed with "JWT " - strip this prefix before using as Bearer token - The `device_id` should be unique per device and reused across sessions ## Example Request: ``` POST /v1/auth/signin Content-Type: application/json Authorization: JWT { "auth_type": "header", "email": "user@example.com", "password": "password123", "device_id": "550e8400-e29b-41d4-a716-446655440000" } ``` Response Header: ``` Authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` Use token with V2 API: ``` Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` ```markdown ### Parameters - **authorization** (string (JWT), header, required): Must be 'JWT' for header-based auth ### Request Body **Content-Type:** application/json - **auth_type** (string (header)) (required): Authentication type - use 'header' to receive token in response header ("header") - **email** (string) (required): User's email address or username - **password** (string) (required): User's password - **device_id** (string) (required): Unique device identifier (UUID recommended). Should be persisted and reused. ### Responses #### 200 - The request has succeeded. **SignInResponse** - **user** (object) (required): Brief user information - **id** (string) (required): Unique user identifier - **ingameName** (string) (required): In-game name - **avatar** (string): Path to user avatar - **reputation** (integer (int32)) (required): User reputation score - **locale** (string) (required): Preferred locale - **platform** (string (pc|ps4|xbox|switch|mobile)) (required): Supported gaming platforms. ("pc"|"ps4"|"xbox"|"switch"|"mobile") - **crossplay** (boolean) (required): Whether cross-play is enabled - **status** (string (offline|online|ingame|invisible)) (required): User online status. ("offline"|"online"|"ingame"|"invisible") - **activity** (object): Current user activity in-game - **type** (string (UNKNOWN|IDLE|ON_MISSION|IN_DOJO|IN_ORBITER|IN_RELAY)) (required): User activity type. ("UNKNOWN"|"IDLE"|"ON_MISSION"|"IN_DOJO"|"IN_ORBITER"|"IN_RELAY") - **details** (string): Activity details (e.g., mission name, max 64 chars) - **startedAt** (string (date-time)): When the activity started - **lastSeen** (string (date-time)): Last seen timestamp #### 400 - 400 Bad Request - Invalid input or validation error. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name #### 401 - 401 Unauthorized - Authentication required or token invalid. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name ### Example Usage ```bash curl -X POST "https://api.warframe.market/v1/auth/signin" \ -H "Content-Type: application/json" \ -d '{ "auth_type": "header", "email": "string", "password": "string", "device_id": "string" }' ``` ``` -------------------------------- ### GET /v2/missions Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all missions. Returns all mission types known to warframe.market. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.Mission)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference - **i18n** (object) (required): I18n wrapper for missions. - **en** (object) (required): I18n content for missions. - **name** (string) (required): Localized mission name - **icon** (string) (required): Path to mission icon - **thumb** (string) (required): Path to mission thumbnail - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/missions" ``` ``` -------------------------------- ### GET /v2/item/{slug} Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get item details. Returns full details for a specific item. ```markdown ### Parameters - **slug** (string, path, required) - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (object) (required): Complete item model with all available fields - **id** (string) (required): Unique item identifier - **slug** (string) (required): URL-friendly item identifier - **gameRef** (string) (required): Internal game reference path - **tradable** (boolean) (required): Whether the item can be traded - **tags** (array (string)) (required): Item categorization tags - **i18n** (object) (required): Full i18n wrapper with descriptions. - **en** (object) (required): Extended i18n content with description and wiki link. - **name** (string) (required): Localized item name - **icon** (string) (required): Path to item icon (relative to static assets base URL) - **thumb** (string) (required): Path to item thumbnail - **subIcon** (string): Path to sub-icon (e.g., blueprint indicator) - **description** (string): Localized item description - **wikiLink** (string): Link to the Warframe wiki page - **rarity** (string (common|uncommon|rare|legendary)): Item rarity. ("common"|"uncommon"|"rare"|"legendary") - **maxRank** (integer (int32)): Maximum mod rank - **maxCharges** (integer (int32)): Maximum charges - **bulkTradable** (boolean): Whether multiple items can be traded at once - **subtypes** (array (string)): Available subtypes - **maxAmberStars** (integer (int32)): Maximum amber stars - **maxCyanStars** (integer (int32)): Maximum cyan stars - **baseEndo** (integer (int32)): Base endo value - **endoMultiplier** (number (float)): Endo multiplier per rank - **ducats** (integer (int32)): Ducat value - **reqMasteryRank** (integer (int32)): Required mastery rank to trade - **vaulted** (boolean): Whether the item is vaulted - **tradingTax** (integer (int32)): Trading tax in credits - **setRoot** (boolean): Whether this item is the root of a set - **setParts** (array (string)): Item IDs that are part of this set - **quantityInSet** (integer (int32)): Quantity of this item in its set - **error** (unknown) (required) #### 404 - 404 Not Found - Resource does not exist. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/item/{slug}" ``` ``` -------------------------------- ### GET /v2/dashboard/showcase Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get dashboard showcase. Returns featured items for the mobile app home screen dashboard. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (object) (required): Featured items showcase for dashboard - **i18n** (object) (required): I18n wrapper for dashboard showcase. - **en** (object) (required): I18n content for dashboard showcase. - **title** (string) (required): Showcase title - **description** (string) (required): Showcase description - **items** (array (Models.DashboardShowcaseItem)) (required): Featured items Array items: - **item** (string) (required): Item ID - **background** (string) (required): Path to background image - **bigCard** (boolean) (required): Whether to display as a large card - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/dashboard/showcase" ``` ``` -------------------------------- ### GET /v2/sister/weapons Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all Sister of Parvos weapons. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.SisterWeapon)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **reqMasteryRank** (integer (int32)): Required mastery rank - **i18n** (object) (required): I18n wrapper for sister weapons. - **en** (object) (required): I18n content for sister weapons. - **name** (string) (required): Localized weapon name - **wikiLink** (string): Link to the Warframe wiki page - **icon** (string) (required): Path to weapon icon - **thumb** (string) (required): Path to weapon thumbnail - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/sister/weapons" ``` ``` -------------------------------- ### Schema: SignInResponse Source: https://kibbewater.github.io/wfm-openapi/openapi.json Sign in response body. ```markdown ## Schema: SignInResponse Sign in response body. **Type:** object - **user** (object) (required): Brief user information - **id** (string) (required): Unique user identifier - **ingameName** (string) (required): In-game name - **avatar** (string): Path to user avatar - **reputation** (integer (int32)) (required): User reputation score - **locale** (string) (required): Preferred locale - **platform** (string (pc|ps4|xbox|switch|mobile)) (required): Supported gaming platforms. ("pc"|"ps4"|"xbox"|"switch"|"mobile") - **crossplay** (boolean) (required): Whether cross-play is enabled - **status** (string (offline|online|ingame|invisible)) (required): User online status. ("offline"|"online"|"ingame"|"invisible") - **activity** (object): Current user activity in-game - **type** (string (UNKNOWN|IDLE|ON_MISSION|IN_DOJO|IN_ORBITER|IN_RELAY)) (required): User activity type. ("UNKNOWN"|"IDLE"|"ON_MISSION"|"IN_DOJO"|"IN_ORBITER"|"IN_RELAY") - **details** (string): Activity details (e.g., mission name, max 64 chars) - **startedAt** (string (date-time)): When the activity started - **lastSeen** (string (date-time)): Last seen timestamp ``` -------------------------------- ### Schema: SignInRequest Source: https://kibbewater.github.io/wfm-openapi/openapi.json Sign in request body. ```markdown ## Schema: SignInRequest Sign in request body. **Type:** object - **auth_type** (string (header)) (required): Authentication type - use 'header' to receive token in response header ("header") - **email** (string) (required): User's email address or username - **password** (string) (required): User's password - **device_id** (string) (required): Unique device identifier (UUID recommended). Should be persisted and reused. ``` -------------------------------- ### GET /v2/sister/quirks Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all Sister of Parvos quirks. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.SisterQuirk)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **group** (string): Quirk group for categorization - **i18n** (object) (required): I18n wrapper for sister quirks. - **en** (object) (required): I18n content for sister quirks. - **name** (string) (required): Localized quirk name - **description** (string): Localized quirk description - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/sister/quirks" ``` ``` -------------------------------- ### GET /v2/sister/ephemeras Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all Sister of Parvos ephemeras. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.SisterEphemera)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **animation** (string): Path to animation preview (webp) - **element** (string): Associated element - **i18n** (object) (required): I18n wrapper for sister ephemeras. - **en** (object) (required): I18n content for sister ephemeras. - **name** (string) (required): Localized ephemera name - **icon** (string) (required): Path to ephemera icon - **thumb** (string) (required): Path to ephemera thumbnail - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/sister/ephemeras" ``` ``` -------------------------------- ### Schema: Models.Theme Source: https://kibbewater.github.io/wfm-openapi/openapi.json UI theme preference. ```markdown ## Schema: Models.Theme UI theme preference. **Type:** string ``` -------------------------------- ### GET /v2/lich/weapons Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all Kuva Lich weapons. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.LichWeapon)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **reqMasteryRank** (integer (int32)): Required mastery rank - **i18n** (object) (required): I18n wrapper for lich weapons. - **en** (object) (required): I18n content for lich weapons. - **name** (string) (required): Localized weapon name - **wikiLink** (string): Link to the Warframe wiki page - **icon** (string) (required): Path to weapon icon - **thumb** (string) (required): Path to weapon thumbnail - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/lich/weapons" ``` ``` -------------------------------- ### Schema: Models.UserShort Source: https://kibbewater.github.io/wfm-openapi/openapi.json Brief user information ```markdown ## Schema: Models.UserShort Brief user information **Type:** object - **id** (string) (required): Unique user identifier - **ingameName** (string) (required): In-game name - **avatar** (string): Path to user avatar - **reputation** (integer (int32)) (required): User reputation score - **locale** (string) (required): Preferred locale - **platform** (string (pc|ps4|xbox|switch|mobile)) (required): Supported gaming platforms. ("pc"|"ps4"|"xbox"|"switch"|"mobile") - **crossplay** (boolean) (required): Whether cross-play is enabled - **status** (string (offline|online|ingame|invisible)) (required): User online status. ("offline"|"online"|"ingame"|"invisible") - **activity** (object): Current user activity in-game - **type** (string (UNKNOWN|IDLE|ON_MISSION|IN_DOJO|IN_ORBITER|IN_RELAY)) (required): User activity type. ("UNKNOWN"|"IDLE"|"ON_MISSION"|"IN_DOJO"|"IN_ORBITER"|"IN_RELAY") - **details** (string): Activity details (e.g., mission name, max 64 chars) - **startedAt** (string (date-time)): When the activity started - **lastSeen** (string (date-time)): Last seen timestamp ``` -------------------------------- ### GET /v2/lich/quirks Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all Kuva Lich quirks. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.LichQuirk)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **group** (string): Quirk group for categorization - **i18n** (object) (required): I18n wrapper for lich quirks. - **en** (object) (required): I18n content for lich quirks. - **name** (string) (required): Localized quirk name - **description** (string): Localized quirk description - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/lich/quirks" ``` ``` -------------------------------- ### GET /v2/lich/ephemeras Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all Kuva Lich ephemeras. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.LichEphemera)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **animation** (string): Path to animation preview (webp) - **element** (string): Associated element - **i18n** (object) (required): I18n wrapper for lich ephemeras. - **en** (object) (required): I18n content for lich ephemeras. - **name** (string) (required): Localized ephemera name - **icon** (string) (required): Path to ephemera icon - **thumb** (string) (required): Path to ephemera thumbnail - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/lich/ephemeras" ``` ``` -------------------------------- ### GET /v2/riven/weapon/{slug} Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get riven weapon details. ```markdown ### Parameters - **slug** (string, path, required) - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (object) (required): Riven mod weapon with disposition and type information - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **group** (string) (required): Weapon group for frontend categorization - **rivenType** (string (kitgun|melee|pistol|rifle|shotgun|zaw)) (required): Riven weapon type. ("kitgun"|"melee"|"pistol"|"rifle"|"shotgun"|"zaw") - **disposition** (number (float)) (required): Riven disposition (affects stat ranges, 0.5-1.55) - **reqMasteryRank** (integer (int32)): Required mastery rank - **i18n** (object) (required): I18n wrapper for riven weapons. - **en** (object) (required): I18n content for riven weapons. - **name** (string) (required): Localized weapon name - **wikiLink** (string): Link to the Warframe wiki page - **icon** (string) (required): Path to weapon icon - **thumb** (string) (required): Path to weapon thumbnail - **error** (unknown) (required) #### 404 - 404 Not Found - Resource does not exist. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/riven/weapon/{slug}" ``` ``` -------------------------------- ### Schema: Models.OrderWithUser Source: https://kibbewater.github.io/wfm-openapi/openapi.json Trading order with seller/buyer information ```markdown ## Schema: Models.OrderWithUser Trading order with seller/buyer information **Type:** object - **id** (string) (required): Unique order identifier - **type** (string (buy|sell)) (required): Order type - buy or sell. ("buy"|"sell") - **platinum** (integer (int32)) (required): Price in platinum - **quantity** (integer (int32)) (required): Available quantity - **perTrade** (integer (int32)): Minimum quantity per trade - **rank** (integer (int32)): Mod rank (for rankable items) - **charges** (integer (int32)): Remaining charges (for consumable items) - **subtype** (string): Item subtype (e.g., blueprint, crafted) - **amberStars** (integer (int32)): Installed amber stars (for Ayatan sculptures) - **cyanStars** (integer (int32)): Installed cyan stars (for Ayatan sculptures) - **visible** (boolean) (required): Whether the order is visible to other users - **createdAt** (string (date-time)) (required): When the order was created - **updatedAt** (string (date-time)) (required): When the order was last updated - **itemId** (string) (required): ID of the item being traded - **group** (string): Order group (default: 'all') - **user** (object) (required): Brief user information - **id** (string) (required): Unique user identifier - **ingameName** (string) (required): In-game name - **avatar** (string): Path to user avatar - **reputation** (integer (int32)) (required): User reputation score - **locale** (string) (required): Preferred locale - **platform** (string (pc|ps4|xbox|switch|mobile)) (required): Supported gaming platforms. ("pc"|"ps4"|"xbox"|"switch"|"mobile") - **crossplay** (boolean) (required): Whether cross-play is enabled - **status** (string (offline|online|ingame|invisible)) (required): User online status. ("offline"|"online"|"ingame"|"invisible") - **activity** (object): Current user activity in-game - **type** (string (UNKNOWN|IDLE|ON_MISSION|IN_DOJO|IN_ORBITER|IN_RELAY)) (required): User activity type. ("UNKNOWN"|"IDLE"|"ON_MISSION"|"IN_DOJO"|"IN_ORBITER"|"IN_RELAY") - **details** (string): Activity details (e.g., mission name, max 64 chars) - **startedAt** (string (date-time)): When the activity started - **lastSeen** (string (date-time)): Last seen timestamp ``` -------------------------------- ### API Overview: warframe.market API Source: https://kibbewater.github.io/wfm-openapi/openapi.json Third-party OpenAPI documentation for the warframe.market API v2. This is an unofficial documentation project. For the official documentation, visit the [Notion page](https://42bytes.notion.site/WFM-Api-v2-Documentation-5d987e4aa2f74b55a80db1a09932459d). ## Base URLs - **V2 API**: `https://api.warframe.market/v2/` - **V1 API** (auth only): `https://api.warframe.market/v1/` - **Static Assets**: `https://warframe.market/static/assets/` ## Authentication Authentication is currently handled via the **V1 API**. To authenticate: 1. Send a POST request to `/v1/auth/signin` with credentials 2. Extract the JWT from the `Authorization` response header (strip "JWT " prefix) 3. Use the token as `Bearer ` in subsequent V2 API requests See the **Authentication (V1)** section for details. **Note**: OAuth 2.0 is planned for future implementation. ## Rate Limits 3 requests per second. Exceeding this limit results in a `429` error. ## Global Headers Most endpoints accept the following headers: - `Language`: Request additional translations (default: `en`) - `Platform`: Filter by platform - `pc`, `ps4`, `xbox`, `switch`, `mobile` (default: `pc`) - `Crossplay`: Include cross-play orders - `true` or `false` (default: `true`) ```yaml # warframe.market API # Version: 0.21.2 Third-party OpenAPI documentation for the warframe.market API v2. This is an unofficial documentation project. For the official documentation, visit the [Notion page](https://42bytes.notion.site/WFM-Api-v2-Documentation-5d987e4aa2f74b55a80db1a09932459d). ## Base URLs - **V2 API**: `https://api.warframe.market/v2/` - **V1 API** (auth only): `https://api.warframe.market/v1/` - **Static Assets**: `https://warframe.market/static/assets/` ## Authentication Authentication is currently handled via the **V1 API**. To authenticate: 1. Send a POST request to `/v1/auth/signin` with credentials 2. Extract the JWT from the `Authorization` response header (strip "JWT " prefix) 3. Use the token as `Bearer ` in subsequent V2 API requests See the **Authentication (V1)** section for details. **Note**: OAuth 2.0 is planned for future implementation. ## Rate Limits 3 requests per second. Exceeding this limit results in a `429` error. ## Global Headers Most endpoints accept the following headers: - `Language`: Request additional translations (default: `en`) - `Platform`: Filter by platform - `pc`, `ps4`, `xbox`, `switch`, `mobile` (default: `pc`) - `Crossplay`: Include cross-play orders - `true` or `false` (default: `true`) # Base URL: https://api.warframe.market ``` -------------------------------- ### GET /v2/sister/weapon/{slug} Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get Sister of Parvos weapon details. ```markdown ### Parameters - **slug** (string, path, required) - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (object) (required): Sister of Parvos (Tenet) weapon - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **reqMasteryRank** (integer (int32)): Required mastery rank - **i18n** (object) (required): I18n wrapper for sister weapons. - **en** (object) (required): I18n content for sister weapons. - **name** (string) (required): Localized weapon name - **wikiLink** (string): Link to the Warframe wiki page - **icon** (string) (required): Path to weapon icon - **thumb** (string) (required): Path to weapon thumbnail - **error** (unknown) (required) #### 404 - 404 Not Found - Resource does not exist. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/sister/weapon/{slug}" ``` ``` -------------------------------- ### Schema: Models.Versions Source: https://kibbewater.github.io/wfm-openapi/openapi.json Version information for resources. ```markdown ## Schema: Models.Versions Version information for resources. **Type:** object - **apps** (object) (required): Mobile app version requirements. - **ios** (string) (required): Latest iOS version - **android** (string) (required): Latest Android version - **minIos** (string) (required): Minimum supported iOS version - **minAndroid** (string) (required): Minimum supported Android version - **collections** (object) (required): Collection version hashes for cache invalidation. - **items** (string) (required): Items collection version - **rivens** (string) (required): Rivens collection version - **liches** (string) (required): Liches collection version - **sisters** (string) (required): Sisters collection version - **missions** (string) (required): Missions collection version - **npcs** (string) (required): NPCs collection version - **locations** (string) (required): Locations collection version - **updatedAt** (string (date-time)) (required): When versions were last updated ``` -------------------------------- ### GET /v2/npcs Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all NPCs. Returns all NPCs known to warframe.market. ```markdown ### Parameters - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.Npc)) (required) Array items: - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference - **i18n** (object) (required): I18n wrapper for NPCs. - **en** (object) (required): I18n content for NPCs. - **name** (string) (required): Localized NPC name - **icon** (string) (required): Path to NPC icon - **thumb** (string) (required): Path to NPC thumbnail - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/npcs" ``` ``` -------------------------------- ### GET /v2/lich/weapon/{slug} Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get Kuva Lich weapon details. ```markdown ### Parameters - **slug** (string, path, required) - **Language** (string, header, optional): Request translations in addition to English. Supported: ko, ru, de, fr, pt, zh-hans, zh-hant, es, it, pl, uk, en ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (object) (required): Kuva Lich weapon - **id** (string) (required): Unique identifier - **slug** (string) (required): URL-friendly identifier - **gameRef** (string) (required): Internal game reference path - **reqMasteryRank** (integer (int32)): Required mastery rank - **i18n** (object) (required): I18n wrapper for lich weapons. - **en** (object) (required): I18n content for lich weapons. - **name** (string) (required): Localized weapon name - **wikiLink** (string): Link to the Warframe wiki page - **icon** (string) (required): Path to weapon icon - **thumb** (string) (required): Path to weapon thumbnail - **error** (unknown) (required) #### 404 - 404 Not Found - Resource does not exist. **Common.ErrorResponse** - **apiVersion** (string) (required) - **data** (unknown) (required) - **error** (object) (required): API error details - **request** (array (string)): General request-level errors - **inputs** (object): Input-level validation errors keyed by field name ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/lich/weapon/{slug}" ``` ``` -------------------------------- ### Schema: Models.CreateOrderRequest Source: https://kibbewater.github.io/wfm-openapi/openapi.json Request body for creating an order. ```markdown ## Schema: Models.CreateOrderRequest Request body for creating an order. **Type:** object - **itemId** (string) (required): ID of the item to create an order for - **type** (string (buy|sell)) (required): Order type - buy or sell. ("buy"|"sell") - **platinum** (integer (int32)) (required): Price in platinum (minimum: 1) - **quantity** (integer (int32)) (required): Quantity available (minimum: 1) - **visible** (boolean): Whether the order should be visible - **perTrade** (integer (int32)): Minimum quantity per trade - **rank** (integer (int32)): Mod rank - **charges** (integer (int32)): Remaining charges - **subtype** (string): Item subtype - **amberStars** (integer (int32)): Installed amber stars - **cyanStars** (integer (int32)): Installed cyan stars ``` -------------------------------- ### Schema: Common.GlobalHeaders Source: https://kibbewater.github.io/wfm-openapi/openapi.json All global headers combined. ```markdown ## Schema: Common.GlobalHeaders All global headers combined. **Type:** object ``` -------------------------------- ### GET /v2/achievements Source: https://kibbewater.github.io/wfm-openapi/openapi.json Get all achievements. Returns a list of all available achievements. ```markdown ### Responses #### 200 - The request has succeeded. - **apiVersion** (string) (required) - **data** (array (Models.Achievement)) (required) Array items: - **id** (string) (required): Achievement ID - **slug** (string) (required): URL-friendly identifier - **type** (string (patreon|github|custom)) (required): Achievement type. ("patreon"|"github"|"custom") - **goal** (integer (int32)): Goal to complete the achievement - **i18n** (object) (required): I18n wrapper for achievements. - **en** (object) (required): I18n content for achievements. - **name** (string) (required): Achievement name - **description** (string) (required): Achievement description - **icon** (string): Path to achievement icon - **thumb** (string): Path to achievement thumbnail - **state** (object): Achievement progress state. - **featured** (boolean) (required): Whether achievement is featured on profile - **progress** (integer (int32)) (required): Current progress toward goal - **completedAt** (string (date-time)): When the achievement was completed - **error** (unknown) (required) ### Example Usage ```bash curl -X GET "https://api.warframe.market/v2/achievements" ``` ``` -------------------------------- ### Schema: Models.Tier Source: https://kibbewater.github.io/wfm-openapi/openapi.json Subscription tier. ```markdown ## Schema: Models.Tier Subscription tier. **Type:** string ```