{ "openapi": "3.0.1", "info": { "title": "BUFF163 API", "version": "1.0.0", "description": "BUFF163 publishes a developer API covering market data, buy orders, sell orders, account state, and standard-item purchases. This reference documents those 30 operations together with four read-only price routes used by the BUFF web frontend.\n\nOperations are grouped by access level. Groups named `Official` are supported by BUFF and described in its [developer documentation](https://buff.163.com/developer/documentation). The `Internal API` group is unofficial and can change without notice.\n\n## Base URL\n\n`https://buff.163.com`\n\n## Authentication\n\nOfficial operations take a bearer token issued from the [BUFF developer console](https://buff.163.com/developer).\n\n```http\nAuthorization: Bearer \n```\n\nInternal operations have no documented credential. Some answer anonymous requests; others require the cookies of a signed-in BUFF session, sent in the `Cookie` header. Keep those cookies server-side.\n\n## Requests\n\nGET operations take query parameters. Official POST, PUT, and DELETE operations take a JSON body. Paginated official operations use `page_num` and `page_size`.\n\nPrices are in Chinese yuan and timestamps are Unix seconds unless an operation states otherwise.\n\n## Responses\n\nBoth APIs return an application-level `code` and `msg`. A `200` status does not mean the operation succeeded; check those fields on every response.\n\nAccess level, update frequency, and rate limit differ per operation and are stated on each one.\n\n## Related documents\n\n- [Official BUFF163 API documentation](https://buff.163.com/developer/documentation)\n- [OpenAPI document for this reference](https://buff163api.com/openapi.json)\n- [Internal-route capture evidence](https://buff163api.com/unofficial-routes.json)\n\nThis is an unofficial reference, not affiliated with or endorsed by NetEase or BUFF.", "summary": "Reference for BUFF163's official developer API and four internal price endpoints used by the BUFF web frontend." }, "components": { "schemas": { "asset_info": { "type": "object", "description": "Item detail info.", "properties": { "assetid": { "type": "string", "example": "51073537258" }, "classid": { "type": "string", "example": "7993036004" }, "contextid": { "type": "integer", "example": 2 }, "goods_id": { "type": "integer", "description": "BUFF goods ID", "example": 58835 }, "id": { "type": "string", "example": "M1094062769" }, "instanceid": { "type": "string", "example": "302028390" }, "paintwear": { "type": "string", "description": "Paint wear, only for weapon type", "example": "0.27153879404067993" }, "info": { "type": "object", "description": "Item additional info", "properties": { "fraudwarnings": { "type": "string", "description": "Name tag", "example": "", "nullable": true }, "paintindex": { "type": "integer", "description": "Paint index.", "example": 785 }, "paintseed": { "type": "integer", "description": "Paint seed.", "example": 845 }, "stickers": { "type": "array", "description": "Sticker info", "items": { "type": "object", "properties": { "sticker_id": { "type": "integer", "description": "Sticker ID" }, "slot": { "type": "integer", "description": "Sticker slot" }, "wear": { "type": "number", "description": "Sticker wear" }, "category": { "type": "string", "description": "Sticker category" }, "market_hash_name": { "type": "string", "description": "Sticker market hash name" }, "offset_x": { "type": "number", "description": "Sticker X offset" }, "offset_y": { "type": "number", "description": "Sticker Y offset" }, "rotation": { "type": "number", "description": "Sticker rotation" } } } }, "tournament_tags": { "type": "array", "description": "Tournament tag info", "items": { "type": "object", "properties": { "category": { "type": "string", "description": "Tournament category" }, "internal_name": { "type": "string", "description": "Tournament internal name" } } } }, "inspect_info": { "type": "object", "description": "Inspect info, contains inspect URL etc.", "properties": { "game_release_date": { "type": "string", "description": "Game release date" }, "inspect_url": { "type": "string", "description": "Inspect URL" }, "is_charm": { "type": "boolean", "description": "Whether it's a charm" }, "is_customplayer": { "type": "boolean", "description": "Whether it's a custom player model" } } }, "keychains": { "type": "array", "description": "Keychain info" } } } } }, "MarketCatalogResponse": { "oneOf": [ { "type": "object", "properties": { "code": { "type": "string" }, "msg": { "description": "Nullable; the non-null type is unspecified." }, "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "description": "Catalog item shape documented by buff163-unofficial-api 0.1.3.", "properties": { "id": { "type": "integer" }, "market_hash_name": { "type": "string" }, "name": { "type": "string" }, "short_name": { "type": "string" }, "buy_max_price": { "type": "string" }, "buy_num": { "type": "integer" }, "sell_min_price": { "type": "string" }, "sell_num": { "type": "integer" }, "sell_reference_price": { "type": "string" }, "market_min_price": { "type": "integer" }, "quick_price": { "type": "string" }, "transacted_num": { "type": "integer" }, "steam_market_url": { "type": "string", "format": "uri" }, "can_bargain": { "type": "boolean" }, "goods_info": { "type": "object", "properties": { "icon_url": { "type": "string", "format": "uri" }, "original_icon_url": { "type": "string", "format": "uri" }, "steam_price": { "type": "string" }, "steam_price_cny": { "type": "string" }, "info": { "type": "object" } } } } } }, "page_num": { "type": "integer" }, "page_size": { "type": "integer" }, "total_count": { "type": "integer" }, "total_page": { "type": "integer" } } } } }, { "type": "object", "properties": { "code": { "type": "string", "example": "Login Required" }, "error": { "type": "string" }, "extra": { "type": "object" } }, "required": [ "code" ] } ] }, "GoodsInfoResponse": { "type": "object", "properties": { "code": { "type": "string" }, "data": { "type": "object", "properties": { "id": { "type": "integer" }, "appid": { "type": "integer" }, "game": { "type": "string" }, "name": { "type": "string" }, "short_name": { "type": "string" }, "super_short_name": { "type": "string" }, "market_hash_name": { "type": "string" }, "transacted_num": { "type": "integer" }, "description": { "description": "Nullable; the non-null type is unspecified." }, "steam_market_url": { "type": "string" }, "goods_info": { "type": "object", "properties": { "icon_url": { "type": "string" }, "steam_price": { "type": "string" }, "item_id": { "description": "Nullable; the non-null type is unspecified." }, "info": { "type": "object", "properties": { "tags": { "type": "object", "properties": { "type": { "type": "object", "properties": { "id": { "type": "integer" }, "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "rarity": { "type": "object", "properties": { "id": { "type": "integer" }, "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "weapon": { "type": "object", "properties": { "id": { "type": "integer" }, "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "quality": { "type": "object", "properties": { "id": { "type": "integer" }, "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "exterior": { "type": "object", "properties": { "id": { "type": "integer" }, "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } } } } } }, "steam_price_cny": { "type": "string" }, "original_icon_url": { "type": "string" }, "can_inspect": { "type": "boolean" }, "can_3d_inspect": { "type": "boolean" }, "can_display_inspect": { "type": "boolean" }, "can_preview": { "type": "boolean" }, "can_preview_upload": { "type": "boolean" }, "can_search_by_sticker": { "type": "boolean" }, "can_search_by_patch": { "type": "boolean" }, "can_search_by_tournament": { "type": "boolean" }, "search_tag": { "description": "Nullable; the non-null type is unspecified." }, "normal_icon_url": { "type": "string" }, "can_specific_buy": { "type": "boolean" }, "specific": { "type": "array", "items": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "buy_max_price": { "type": "string" }, "name": { "type": "string" }, "sell_min_price": { "type": "string" }, "value": { "type": "integer" } } } }, "limit": { "type": "integer" }, "name": { "type": "string" }, "specific_type": { "type": "string" }, "type": { "type": "string" } } } }, "can_specific_paintwear_buy": { "type": "boolean" }, "specific_paintwear_buying_choices": { "type": "array", "items": {} }, "can_specific_fade_buy": { "type": "boolean" }, "specific_fade_buying_ranges": { "type": "array", "items": {} }, "wear_rank_order_list": { "type": "array", "items": { "type": "object", "properties": { "display_text": { "type": "string" }, "order_type": { "type": "string" } } } } } }, "item_id": { "description": "Nullable; the non-null type is unspecified." }, "wiki_link": { "description": "Nullable; the non-null type is unspecified." }, "user_show_count": { "type": "integer" }, "recent_sold_count": { "type": "integer" }, "has_fade_name": { "type": "boolean" }, "can_buy": { "type": "boolean" }, "can_sort_by_heat": { "type": "boolean" }, "paintwear_range": { "type": "array", "items": { "type": "string" } }, "paintwear_choices": { "type": "array", "items": { "type": "array", "items": { "type": "string" } } }, "rent_day_choices": { "type": "array", "items": { "type": "string" } }, "fade_choices": { "type": "array", "items": { "type": "array", "items": { "type": "string" } } }, "support_name_tag": { "type": "boolean" }, "support_charm": { "type": "boolean" }, "has_paintwear_rank": { "type": "boolean" }, "bookmarked": { "type": "boolean" }, "has_rune": { "type": "boolean" }, "has_overprint_name": { "type": "boolean" }, "asset_tags": { "type": "array", "items": { "type": "object", "properties": { "category": { "description": "Nullable; the non-null type is unspecified." }, "depth": { "type": "integer" }, "items": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" } } } }, "name": { "type": "string" }, "type": { "type": "string" } } } }, "asset_tags_history": { "type": "array", "items": { "type": "object", "properties": { "category": { "description": "Nullable; the non-null type is unspecified." }, "depth": { "type": "integer" }, "items": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" } } } }, "name": { "type": "string" }, "type": { "type": "string" } } } }, "asset_tags_buy_order": { "type": "array", "items": { "type": "object", "properties": { "category": { "description": "Nullable; the non-null type is unspecified." }, "depth": { "type": "integer" }, "items": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer", "nullable": true }, "name": { "type": "string" } } } }, "name": { "type": "string" }, "type": { "type": "string" } } } }, "paintseed_filters": { "type": "array", "items": { "type": "object", "properties": { "max": { "type": "integer" }, "name": { "type": "string" }, "placeholder": { "type": "string" }, "search": { "type": "boolean" }, "type": { "type": "string" } } } }, "paintseed_filters_history": { "type": "array", "items": {} }, "paintseed_filters_buy_order": { "type": "array", "items": {} }, "rank_types": { "type": "array", "items": { "type": "object", "properties": { "depth": { "type": "integer" }, "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "integer" } } } }, "name": { "type": "string" }, "type": { "type": "string" } } } }, "deliver_deposit_filters": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "default_value": { "type": "integer" }, "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "value": { "type": "integer" } } } } } } }, "title": { "type": "string" } } }, "history_order_type_filters": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "value": { "type": "integer" } } } } } } }, "title": { "type": "string" } } }, "sort_by_fields": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "default_value": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "value": { "type": "string" } } } } } } }, "title": { "type": "string" } } }, "rent_sort_by_fields": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "default_value": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "value": { "type": "string" } } } } } } }, "title": { "type": "string" } } }, "auction_sort_by_fields": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "default_value": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "value": { "type": "string" } } } } } } }, "title": { "type": "string" } } }, "pre_sell_sort_by_fields": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "default_value": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "value": { "type": "string" } } } } } } }, "title": { "type": "string" } } }, "share_data": { "type": "object", "properties": { "share_task_type": { "type": "integer" }, "content": { "type": "string" }, "thumbnail": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } } }, "containers": { "type": "array", "items": { "type": "string" } }, "container_type": { "type": "string" }, "is_container": { "type": "boolean" }, "has_related": { "type": "boolean" }, "has_buff_price_history": { "type": "boolean" }, "allow_bundle_inventory": { "type": "boolean" }, "has_bundle_inventory_order": { "type": "boolean" }, "has_rent_order": { "type": "boolean" }, "relative_goods": { "type": "array", "items": { "type": "object", "properties": { "auction_num": { "type": "integer" }, "goods_id": { "type": "integer" }, "goods_name": { "type": "string" }, "is_change": { "type": "boolean" }, "sell_min_price": { "type": "string" }, "sell_num": { "type": "integer" }, "tag": { "type": "string" }, "tag_name": { "type": "string" } } } }, "buy_num": { "type": "integer" }, "sell_num": { "type": "integer" }, "rent_num": { "type": "integer" }, "auction_num": { "type": "integer" }, "pre_sell_num": { "type": "integer" }, "buy_max_price": { "type": "string" }, "sell_min_price": { "type": "string" }, "sell_reference_price": { "type": "string" }, "quick_price": { "type": "string" }, "market_min_price": { "type": "string" }, "pre_sell_min_price": { "type": "string" }, "is_charm": { "type": "boolean" }, "keychain_color_img": { "type": "string" }, "show_game_cms_icon": { "type": "boolean" } } }, "msg": { "description": "Nullable; the non-null type is unspecified." } } }, "PopularSellOrderResponse": { "type": "object", "properties": { "code": { "type": "string" }, "data": { "type": "object", "properties": { "cs2_inspect_infos": { "type": "object" }, "goods_infos": { "type": "object", "additionalProperties": { "type": "object", "properties": { "appid": { "type": "integer" }, "description": { "description": "Nullable; the non-null type is unspecified." }, "game": { "type": "string" }, "goods_id": { "type": "integer" }, "icon_url": { "type": "string" }, "is_charm": { "type": "boolean" }, "item_id": { "description": "Nullable; the non-null type is unspecified." }, "keychain_color_img": { "description": "Nullable; the non-null type is unspecified." }, "market_hash_name": { "type": "string" }, "market_min_price": { "type": "string" }, "name": { "type": "string" }, "original_icon_url": { "type": "string" }, "sell_min_price": { "type": "string" }, "sell_reference_price": { "type": "string" }, "short_name": { "type": "string" }, "steam_price": { "type": "string" }, "steam_price_cny": { "type": "string" }, "tags": { "type": "object", "properties": { "category": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "category_group": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "custom": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "exterior": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "itemset": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "model_version": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "proplayer": { "type": "object", "properties": { "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "quality": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "rarity": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "series": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "tournament": { "type": "object", "properties": { "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "tournamentteam": { "type": "object", "properties": { "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "type": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "weapon": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "weaponcase": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } } } } } } }, "items": { "type": "array", "items": { "type": "object", "properties": { "allow_bargain": { "type": "boolean" }, "allow_bargain_chat": { "type": "boolean" }, "allow_bargain_swap": { "type": "boolean" }, "allow_pending_divide_balance": { "type": "boolean" }, "appid": { "type": "integer" }, "asset_info": { "type": "object", "properties": { "action_link": { "type": "string" }, "appid": { "type": "integer" }, "assetid": { "type": "string" }, "classid": { "type": "string" }, "contextid": { "type": "integer" }, "goods_id": { "type": "integer" }, "has_tradable_cooldown": { "type": "boolean" }, "id": { "type": "string" }, "info": { "type": "object", "properties": { "fraudwarnings": { "type": "string", "nullable": true }, "icon_url": { "type": "string" }, "inspect_start_at": { "type": "string" }, "inspect_state": { "type": "integer" }, "keychains": { "type": "array", "items": { "type": "object", "properties": { "goods_id": { "type": "integer" }, "highlight_reel": { "type": "integer" }, "highlight_reel_short_text": { "type": "string" }, "highlight_reel_text": { "type": "string" }, "img_url": { "type": "string" }, "is_souvenir": { "type": "boolean" }, "is_sticker_slab": { "type": "boolean" }, "name": { "type": "string" }, "pattern": { "type": "integer", "nullable": true }, "pattern_color": { "type": "string" }, "sell_reference_price": { "type": "string" }, "slot": { "type": "integer" }, "sticker_id": { "type": "integer" }, "video_info": { "type": "object", "properties": { "url": { "type": "string" }, "vframe": { "type": "string" } } }, "wrapped_sticker": { "type": "integer", "nullable": true } } } }, "metaphysic": { "type": "object", "properties": { "data": { "type": "object", "properties": { "color": { "type": "string" }, "name": { "type": "string" } } }, "title": { "type": "string" } } }, "original_icon_url": { "type": "string" }, "paintindex": { "type": "integer" }, "paintseed": { "type": "integer" }, "phase_data": { "type": "object", "properties": { "color": { "type": "string" }, "name": { "type": "string" } } }, "stickers": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "img_url": { "type": "string" }, "name": { "type": "string" }, "offset_x": { "type": "number" }, "offset_y": { "type": "number" }, "sell_reference_price": { "type": "string" }, "slot": { "type": "integer" }, "sticker_id": { "type": "integer" }, "wear": { "type": "number" } } } }, "tier_data": { "type": "object", "properties": { "color": { "type": "string" }, "name": { "type": "string" } } }, "tournament_tags": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } } } } }, "instanceid": { "type": "string" }, "paintwear": { "type": "string" }, "tradable_cooldown_text": { "type": "string" }, "tradable_unfrozen_time": { "description": "Nullable; the non-null type is unspecified." } } }, "coupon_infos": { "type": "array", "items": { "type": "object", "properties": { "cdkey_id": { "type": "string" }, "cdkey_text": { "type": "string" }, "coupon_type": { "type": "string" } } }, "nullable": true }, "created_at": { "type": "integer" }, "deliver_deposit": { "type": "string", "nullable": true }, "description": { "type": "string" }, "featured": { "type": "integer" }, "fee": { "type": "string" }, "fold_asset_count": { "description": "Nullable; the non-null type is unspecified." }, "fold_unique_key": { "description": "Nullable; the non-null type is unspecified." }, "game": { "type": "string" }, "goods_id": { "type": "integer" }, "id": { "type": "string" }, "income": { "type": "string" }, "lowest_bargain_price": { "type": "string" }, "mode": { "type": "integer" }, "order_type": { "type": "integer" }, "price": { "type": "string" }, "recent_average_duration": { "description": "Nullable; the non-null type is unspecified." }, "recent_deliver_rate": { "description": "Nullable; the non-null type is unspecified." }, "state": { "type": "integer" }, "state_text": { "type": "string" }, "sticker_premium": { "type": "number", "nullable": true }, "tradable_cooldown": { "description": "Nullable; the non-null type is unspecified." }, "updated_at": { "type": "integer" }, "user_id": { "type": "string" }, "user_steamid": { "type": "string" } } } }, "show_game_cms_icon": { "type": "boolean" }, "user_infos": { "type": "object", "additionalProperties": { "type": "object", "properties": { "avatar": { "type": "string" }, "avatar_safe": { "type": "string" }, "is_auto_accept": { "type": "boolean" }, "is_premium_vip": { "type": "boolean" }, "nickname": { "type": "string" }, "seller_level": { "type": "integer" }, "shop_id": { "type": "string" }, "user_id": { "type": "string" }, "v_types": { "type": "array", "items": { "type": "string" }, "nullable": true } } } } } }, "msg": { "description": "Nullable; the non-null type is unspecified." } } }, "BuyOrderResponse": { "type": "object", "properties": { "code": { "type": "string" }, "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "allow_tradable_cooldown": { "type": "integer" }, "appid": { "type": "integer" }, "created_at": { "type": "integer" }, "expire_time": { "type": "integer", "nullable": true }, "fee": { "type": "string" }, "frozen_amount": { "type": "string" }, "frozen_num": { "type": "integer" }, "game": { "type": "string" }, "goods_id": { "type": "integer" }, "icon_url": { "type": "string" }, "id": { "type": "string" }, "num": { "type": "integer" }, "pay_expire_timeout": { "type": "integer" }, "pay_method": { "type": "integer" }, "pay_method_text": { "type": "string" }, "price": { "type": "string" }, "real_num": { "type": "integer" }, "specific": { "type": "array", "items": { "type": "object", "properties": { "color": { "type": "string" }, "simple_text": { "type": "string" }, "text": { "type": "string" }, "type": { "type": "string" }, "values": { "type": "array", "items": { "oneOf": [ { "type": "string" }, { "type": "integer" } ] } } } } }, "state": { "type": "string" }, "state_text": { "type": "string" }, "supported_pay_channels": { "type": "array", "items": { "type": "string" } }, "tradable_cooldown": { "description": "Nullable; the non-null type is unspecified." }, "updated_at": { "type": "integer" }, "user_id": { "type": "string" } } } }, "page_num": { "type": "integer" }, "page_size": { "type": "integer" }, "show_pay_method_icon": { "type": "boolean" }, "total_count": { "type": "integer" }, "total_page": { "type": "integer" }, "user_infos": { "type": "object", "additionalProperties": { "type": "object", "properties": { "avatar": { "type": "string", "nullable": true }, "avatar_safe": { "type": "string" }, "is_auto_accept": { "type": "boolean" }, "is_premium_vip": { "type": "boolean" }, "nickname": { "type": "string" }, "seller_level": { "type": "integer" }, "shop_id": { "type": "string" }, "user_id": { "type": "string" }, "v_types": { "type": "array", "items": { "type": "string" }, "nullable": true } } } } } }, "msg": { "description": "Nullable; the non-null type is unspecified." } } }, "SellOrderResponse": { "type": "object", "properties": { "code": { "type": "string" }, "data": { "type": "object", "properties": { "goods_infos": { "type": "object", "additionalProperties": { "type": "object", "properties": { "appid": { "type": "integer" }, "can_3d_inspect": { "type": "boolean" }, "can_inspect": { "type": "boolean" }, "description": { "description": "Nullable; the non-null type is unspecified." }, "game": { "type": "string" }, "goods_id": { "type": "integer" }, "icon_url": { "type": "string" }, "is_charm": { "type": "boolean" }, "item_id": { "description": "Nullable; the non-null type is unspecified." }, "keychain_color_img": { "description": "Nullable; the non-null type is unspecified." }, "market_hash_name": { "type": "string" }, "market_min_price": { "type": "string" }, "name": { "type": "string" }, "original_icon_url": { "type": "string" }, "sell_min_price": { "type": "string" }, "sell_reference_price": { "type": "string" }, "short_name": { "type": "string" }, "steam_price": { "type": "string" }, "steam_price_cny": { "type": "string" }, "tags": { "type": "object", "properties": { "category": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "category_group": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "custom": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "exterior": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "itemset": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "model_version": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "quality": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "rarity": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "series": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "type": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "weapon": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } }, "weaponcase": { "type": "object", "properties": { "category": { "type": "string" }, "id": { "type": "integer" }, "internal_name": { "type": "string" }, "localized_name": { "type": "string" } } } } } } } }, "has_market_stores": { "type": "object", "additionalProperties": { "type": "boolean" } }, "items": { "type": "array", "items": { "type": "object", "properties": { "allow_bargain": { "type": "boolean" }, "allow_bargain_chat": { "type": "boolean" }, "allow_bargain_swap": { "type": "boolean" }, "allow_pending_divide_balance": { "type": "boolean" }, "appid": { "type": "integer" }, "asset_info": { "type": "object", "properties": { "action_link": { "type": "string" }, "appid": { "type": "integer" }, "assetid": { "type": "string" }, "classid": { "type": "string" }, "contextid": { "type": "integer" }, "goods_id": { "type": "integer" }, "has_tradable_cooldown": { "type": "boolean" }, "id": { "type": "string" }, "info": { "type": "object", "properties": { "fraudwarnings": { "type": "string", "nullable": true }, "icon_url": { "type": "string" }, "inspect_en_size": { "type": "string" }, "inspect_en_url": { "type": "string" }, "inspect_mobile_size": { "type": "string" }, "inspect_mobile_url": { "type": "string" }, "inspect_size": { "type": "string" }, "inspect_start_at": { "type": "string" }, "inspect_state": { "type": "integer" }, "inspect_trn_size": { "type": "string" }, "inspect_trn_url": { "description": "Nullable; the non-null type is unspecified." }, "inspect_url": { "type": "string" }, "inspect_version": { "type": "integer" }, "inspected_at": { "type": "string" }, "keychains": { "type": "array", "items": {} }, "metaphysic": { "type": "object", "properties": { "data": { "type": "object", "properties": { "color": { "type": "string" }, "name": { "type": "string" } } }, "title": { "type": "string" } } }, "original_icon_url": { "type": "string" }, "paintindex": { "type": "integer" }, "paintseed": { "type": "integer" }, "phase_data": { "type": "object", "properties": { "color": { "type": "string" }, "name": { "type": "string" } } }, "stickers": { "type": "array", "items": {} }, "tournament_tags": { "type": "array", "items": {} } } }, "instanceid": { "type": "string" }, "paintwear": { "type": "string" }, "tradable_cooldown_text": { "type": "string" }, "tradable_unfrozen_time": { "description": "Nullable; the non-null type is unspecified." } } }, "bookmarked": { "type": "boolean" }, "can_bargain": { "type": "boolean" }, "can_bargain_chat": { "type": "boolean" }, "can_bargain_swap": { "type": "boolean" }, "cannot_bargain_reason": { "type": "string" }, "created_at": { "type": "integer" }, "deliver_deposit": { "type": "string", "nullable": true }, "description": { "type": "string" }, "featured": { "type": "integer" }, "fee": { "type": "string" }, "game": { "type": "string" }, "goods_id": { "type": "integer" }, "id": { "type": "string" }, "income": { "type": "string" }, "mode": { "type": "integer" }, "order_type": { "type": "integer" }, "price": { "type": "string" }, "recent_average_duration": { "type": "number", "nullable": true }, "recent_deliver_rate": { "type": "number", "nullable": true }, "state": { "type": "integer" }, "state_text": { "type": "string" }, "sticker_premium": { "description": "Nullable; the non-null type is unspecified." }, "supported_pay_channels": { "type": "array", "items": { "type": "string" } }, "supported_pay_methods": { "type": "array", "items": { "type": "integer" } }, "tradable_cooldown": { "description": "Nullable; the non-null type is unspecified." }, "updated_at": { "type": "integer" }, "user_id": { "type": "string" }, "user_steamid": { "type": "string" } } } }, "page_num": { "type": "integer" }, "page_size": { "type": "integer" }, "sort_by": { "type": "string" }, "total_count": { "type": "integer" }, "total_page": { "type": "integer" }, "user_infos": { "type": "object", "additionalProperties": { "type": "object", "properties": { "avatar": { "type": "string", "nullable": true }, "avatar_safe": { "type": "string" }, "is_auto_accept": { "type": "boolean" }, "is_premium_vip": { "type": "boolean" }, "nickname": { "type": "string" }, "seller_level": { "type": "integer" }, "shop_id": { "type": "string" }, "user_id": { "type": "string" }, "v_types": { "type": "array", "items": { "type": "string" }, "nullable": true } } } } } }, "msg": { "description": "Nullable; the non-null type is unspecified." } } } }, "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "BUFF developer API token. Send it as `Authorization: Bearer `." }, "sessionCookie": { "type": "apiKey", "in": "header", "name": "Cookie", "description": "Your BUFF session Cookie header. Keep it server-side." } } }, "tags": [ { "name": "Official · Market Data", "description": "Official price, liquidity, and listing-data endpoints." }, { "name": "Official · Buy Orders", "description": "Official buy-order management endpoints." }, { "name": "Official · Sell Orders", "description": "Official inventory and sell-order management endpoints." }, { "name": "Official · Account", "description": "Official BUFF and Steam account endpoints." }, { "name": "Official · Purchases", "description": "Official standard-item purchase and gifting endpoints." }, { "name": "Internal API · Prices", "description": "Internal catalog, sell-listing, and buy-order endpoints." } ], "paths": { "/api/market/items": { "get": { "summary": "Get lowest listing prices", "description": "Returns the lowest listed price for one item or the complete BUFF catalog.\n\n- **Access:** Developer or Enterprise API\n- **Coverage:** All items\n- **Updated:** Every 5 minutes when `include_sticker=0`; every 10 minutes when `include_sticker=1`\n- **Limit:** 500 requests per 24 hours\n\n`goods_id` is optional. Without it, one request returns prices for more than 20,000 items.", "tags": [ "Official · Market Data" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "min_price", "in": "query", "description": "Filter by lowest listing price, optional.", "required": false, "example": 10.01, "schema": { "type": "number", "minimum": 0 } }, { "name": "goods_id", "in": "query", "description": "Return only this BUFF goods ID.", "required": false, "example": 43012, "schema": { "type": "integer" } }, { "name": "market_hash_name", "in": "query", "description": "Return only this Steam market hash name.", "required": false, "example": "★ Karambit | Gamma Doppler (Minimal Wear)", "schema": { "type": "string" } }, { "name": "include_sticker", "in": "query", "description": "Only takes effect when goods_id is not specified. When include_sticker is 0, the results will not include items with sealed graffiti, stickers or sticker slab, and the data will be more real-time.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "type": "array", "items": { "type": "object", "properties": { "goods_id": { "type": "integer", "description": "BUFF item ID" }, "name": { "type": "string", "description": "Item display name" }, "market_hash_name": { "type": "string", "description": "Steam item name" }, "update_time": { "type": "integer", "description": "stat date update time" }, "sales": { "type": "array", "items": { "type": "object", "properties": { "min_price": { "type": "string", "description": "Min listing price" }, "pre_sell_min_price": { "type": "string", "description": "Pre-sell minimum price" }, "min_float": { "type": "string", "description": "Minimum float value" }, "max_float": { "type": "string", "description": "Maximum float value" }, "tag_id": { "type": "integer", "description": "BUFF pattern ID" }, "tag_name": { "type": "string", "description": "BUFF pattern name" } }, "required": [ "min_price", "pre_sell_min_price" ] }, "description": "Price details" } }, "required": [ "goods_id", "market_hash_name", "update_time", "sales" ] }, "description": "Item prices list" }, "stat_time": { "type": "integer", "description": "Price record time" }, "req_remaining": { "type": "integer", "description": "Remaining call time of the API" } }, "required": [ "info", "stat_time", "req_remaining" ] }, "examples": { "1": { "summary": "Example Value", "value": { "info": [ { "goods_id": 10001, "market_hash_name": "★ Karambit | Gamma Doppler (Minimal Wear)", "name": "爪子刀（★） | 伽玛多普勒 (略有磨损)", "sales": [ { "min_price": "12449", "pre_sell_min_price": "12500" }, { "min_price": "16250", "pre_sell_min_price": "0", "tag_id": 522195, "tag_name": "Phase2" }, { "min_price": "12449", "pre_sell_min_price": "12500", "tag_id": 3918883, "tag_name": "Phase3" } ], "update_time": 1785812786 } ], "req_remaining": 500, "stat_time": 1785812400 } } } } }, "headers": {}, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getMarketItems" } }, "/api/market/float/items": { "post": { "summary": "Get float-range market data", "description": "Returns price floors, quantities, fade-range price floors, and liquidity by float range.\n\n- **Access:** Developer or Enterprise API\n- **Coverage:** All items; up to 200 distinct `goods_id` values per day\n- **Updated:** Liquidity daily; other fields every 10 minutes\n- **Limit:** 500 requests per 24 hours\n\nProvide at least one of `market_hash_names` or `goods_ids`. Liquidity is a weighted combination of trade-amount and trade-quantity rankings; BUFF generally considers 85% or higher to be high liquidity.", "tags": [ "Official · Market Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "goods_ids": { "type": "array", "description": "List of item IDs, maximum 200 items, optional (one of goods_ids or market_hash_names required).", "items": { "type": "integer" }, "minItems": 1, "maxItems": 200, "example": [ 33881, 886606 ] }, "market_hash_names": { "type": "array", "description": "List of market_hash_names, maximum 200 items, optional (one of goods_ids or market_hash_names required).", "items": { "type": "string" }, "minItems": 1, "maxItems": 200, "example": [ "AK-47 | Case Hardened (Factory New)", "Dreams & Nightmares Case" ] }, "min_price": { "type": "number", "description": "Price filter parameter, returns only items with price greater than or equal to this value, optional.", "minimum": 0, "example": 10.01 } }, "required": [ "game" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "type": "array", "items": { "type": "object", "properties": { "goods_id": { "type": "integer", "description": "BUFF item ID" }, "name": { "type": "string", "description": "Item display name" }, "market_hash_name": { "type": "string", "description": "Steam item name" }, "update_time": { "type": "integer", "description": "stat date update time" }, "sales": { "type": "array", "items": { "type": "object", "properties": { "liquidity_rank": { "type": "string", "description": "Pattern liquidity index percentage" }, "min_price": { "type": "string", "description": "Min listing price" }, "pre_sell_min_price": { "type": "string", "description": "Pre-sell minimum price" }, "pre_sell_num": { "type": "number", "description": "Valid pre-sell quantity" }, "sell_num": { "type": "number", "description": "Sell quantity" }, "min_float": { "type": "string", "description": "Minimum float value" }, "max_float": { "type": "string", "description": "Maximum float value" }, "tag_id": { "type": "integer", "description": "BUFF pattern ID" }, "tag_name": { "type": "string", "description": "BUFF pattern name" } }, "required": [ "min_price", "sell_num", "pre_sell_min_price", "pre_sell_num" ] }, "description": "Price details" } }, "required": [ "goods_id", "market_hash_name", "update_time", "sales" ] }, "description": "Item prices list" }, "stat_time": { "type": "integer", "description": "Price record time" }, "req_remaining": { "type": "integer", "description": "Remaining call time of the API" } }, "required": [ "info", "stat_time", "req_remaining" ] }, "examples": { "1": { "summary": "Example Value", "value": { "info": [ { "goods_id": 10001, "market_hash_name": "★ Karambit | Gamma Doppler (Minimal Wear)", "name": "爪子刀（★） | 伽玛多普勒 (略有磨损)", "sales": [ { "min_price": "12449", "pre_sell_min_price": "12500", "pre_sell_num": 1, "sell_num": 29 }, { "min_float": "0.07", "max_float": "0.08", "min_price": "12449", "pre_sell_min_price": "12500", "pre_sell_num": 1, "sell_num": 29 }, { "liquidity_rank": "90.35%", "min_price": "16250", "pre_sell_min_price": "0", "pre_sell_num": 0, "sell_num": 9, "tag_id": 522195, "tag_name": "Phase2" }, { "liquidity_rank": "90.35%", "min_float": "0.07", "max_float": "0.08", "min_price": "16250", "pre_sell_min_price": "0", "pre_sell_num": 0, "sell_num": 9, "tag_id": 522195, "tag_name": "Phase2" } ], "update_time": 1785812786 } ], "req_remaining": 500, "stat_time": 1785812400 } } } } }, "headers": {}, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getMarketFloatItems" } }, "/api/market/enterprise/items": { "get": { "summary": "Get enterprise market prices", "description": "Returns the lowest listed price and highest buy-order price for one item or the complete BUFF catalog.\n\n- **Access:** Enterprise API\n- **Coverage:** All items\n- **Updated:** Every 2 minutes with `high_liquidity=1`; every 5 minutes with `include_sticker=0`; otherwise every 10 minutes\n- **Limit:** 5,000 requests per 24 hours\n\n`goods_id` is optional. Without it, one request returns prices for more than 20,000 items. When both `high_liquidity` and `include_sticker` are supplied, `high_liquidity` takes precedence.", "tags": [ "Official · Market Data" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2", "dota2" ] } }, { "name": "goods_id", "in": "query", "description": "Return only this BUFF goods ID.", "required": false, "example": 43871, "schema": { "type": "integer", "minimum": 1 } }, { "name": "market_hash_name", "in": "query", "description": "Return only this Steam market hash name.", "required": false, "example": "★ StatTrak™ Shadow Daggers | Forest DDPAT (Minimal Wear)", "schema": { "type": "string" } }, { "name": "include_sticker", "in": "query", "description": "Only takes effect when goods_id is not specified. When include_sticker is 0, the results will not include items with sealed graffiti, stickers or sticker slab, and the data will be more real-time.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } }, { "name": "high_liquidity", "in": "query", "description": "Only takes effect when goods_id is not specified and game=csgo. When high_liquidity is 1, only high-liquidity items (liquidity rank >= 80%) are returned, data is updated every 2 minutes.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "type": "array", "items": { "type": "object", "properties": { "goods_id": { "type": "integer", "description": "BUFF item ID" }, "name": { "type": "string", "description": "Item display name" }, "market_hash_name": { "type": "string", "description": "Steam item name" }, "update_time": { "type": "integer", "description": "stat date update time" }, "sales": { "type": "array", "items": { "type": "object", "properties": { "min_price": { "type": "string", "description": "Min listing price" }, "pre_sell_min_price": { "type": "string", "description": "Pre-sell minimum price" }, "buy_max_price": { "type": "string", "description": "Max buy order price" }, "tag_id": { "type": "integer", "description": "BUFF pattern ID" }, "tag_name": { "type": "string", "description": "BUFF pattern name" } }, "required": [ "min_price", "buy_max_price", "pre_sell_min_price" ] }, "description": "Price details" } }, "required": [ "goods_id", "market_hash_name", "update_time", "sales" ] }, "description": "Item prices list" }, "stat_time": { "type": "integer", "description": "Price record time" }, "req_remaining": { "type": "integer", "description": "Remaining call time of the API" } }, "required": [ "info", "stat_time", "req_remaining" ] }, "examples": { "1": { "summary": "Example Value", "value": { "info": [ { "goods_id": 10001, "market_hash_name": "★ Karambit | Gamma Doppler (Minimal Wear)", "name": "爪子刀（★） | 伽玛多普勒 (略有磨损)", "sales": [ { "min_price": "12449", "pre_sell_min_price": "12500", "buy_max_price": "11610" }, { "min_price": "16250", "pre_sell_min_price": "0", "buy_max_price": "14880", "tag_id": 522195, "tag_name": "Phase2" }, { "min_price": "12449", "pre_sell_min_price": "12500", "buy_max_price": "11610", "tag_id": 3918883, "tag_name": "Phase3" } ], "update_time": 1785812786 } ], "req_remaining": 5000, "stat_time": 1785812400 } } } } }, "headers": {}, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getEnterpriseMarketItems" } }, "/api/market/enterprise/float/items": { "get": { "summary": "Get enterprise float-range data", "description": "Returns the following values by float range:\n\n- Lowest listing price\n- Listing quantity\n- Average of the 10 lowest listing prices for the item and float range\n- Highest buy-order price\n- Buy-order quantity\n\n**Access:** Enterprise API \n**Coverage:** All items \n**Updated:** Every 5 minutes when `include_sticker=0`; every 10 minutes when `include_sticker=1` \n**Limit:** 5,000 requests per 24 hours\n\n`goods_id` is optional. Without it, one request returns prices for more than 20,000 items.", "tags": [ "Official · Market Data" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2", "dota2" ] } }, { "name": "goods_id", "in": "query", "description": "Return only this BUFF goods ID.", "required": false, "example": 42556, "schema": { "type": "integer", "minimum": 1 } }, { "name": "market_hash_name", "in": "query", "description": "Return only this Steam market hash name.", "required": false, "example": "★ Butterfly Knife | Fade (Factory New)", "schema": { "type": "string" } }, { "name": "include_sticker", "in": "query", "description": "Only takes effect when goods_id is not specified. When include_sticker is 0, the results will not include items with sealed graffiti, stickers or sticker slab, and the data will be more real-time.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "type": "array", "items": { "type": "object", "properties": { "goods_id": { "type": "integer", "description": "BUFF item ID" }, "name": { "type": "string", "description": "Item display name" }, "market_hash_name": { "type": "string", "description": "Steam item name" }, "update_time": { "type": "integer", "description": "stat date update time" }, "sales": { "type": "array", "items": { "type": "object", "properties": { "avg_min_price": { "type": "string", "description": "Average of top 10 lowest listing prices" }, "buy_max_price": { "type": "string", "description": "Max buy order price" }, "min_price": { "type": "string", "description": "Min listing price" }, "pre_sell_min_price": { "type": "string", "description": "Pre-sell minimum price" }, "pre_sell_num": { "type": "number", "description": "Valid pre-sell quantity" }, "sell_num": { "type": "number", "description": "Sell quantity" }, "buy_order_num": { "type": "number", "description": "Buy order quantity" }, "min_float": { "type": "string", "description": "Minimum float value" }, "max_float": { "type": "string", "description": "Maximum float value" }, "tag_id": { "type": "integer", "description": "BUFF pattern ID" }, "tag_name": { "type": "string", "description": "BUFF pattern name" } }, "required": [ "avg_min_price", "buy_max_price", "min_price", "sell_num", "buy_order_num", "pre_sell_min_price", "pre_sell_num" ] }, "description": "Price details and float ranges" } }, "required": [ "goods_id", "market_hash_name", "update_time", "sales" ] }, "description": "Item prices list" }, "stat_time": { "type": "integer", "description": "Price record time" }, "req_remaining": { "type": "integer", "description": "Remaining call time of the API" } }, "required": [ "info", "stat_time", "req_remaining" ] }, "examples": { "1": { "summary": "Example Value", "value": { "info": [ { "goods_id": 10001, "market_hash_name": "★ Karambit | Gamma Doppler (Minimal Wear)", "name": "爪子刀（★） | 伽玛多普勒 (略有磨损)", "sales": [ { "min_price": "12449", "pre_sell_min_price": "12500", "avg_min_price": "14405.55", "buy_max_price": "11610", "sell_num": 29, "pre_sell_num": 1, "buy_order_num": 11 }, { "min_price": "12449", "pre_sell_min_price": "12500", "avg_min_price": "14405.55", "buy_max_price": "11610", "sell_num": 29, "pre_sell_num": 1, "buy_order_num": 3, "min_float": "0.07", "max_float": "0.08" }, { "min_price": "16250", "pre_sell_min_price": "0", "avg_min_price": "23381.55", "buy_max_price": "14880", "sell_num": 9, "pre_sell_num": 0, "buy_order_num": 8, "tag_id": 522195, "tag_name": "Phase2" } ], "update_time": 1785812786 } ], "req_remaining": 5000, "stat_time": 1785812400 } } } } }, "headers": {}, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getEnterpriseMarketFloatItems" } }, "/api/market/enterprise/items/liquidity_rank": { "get": { "summary": "Get item liquidity rankings", "description": "Returns BUFF liquidity rankings for one item or the complete catalog.\n\n- **Access:** Enterprise API\n- **Coverage:** All items\n- **Updated:** Daily\n- **Limit:** 5,000 requests per 24 hours\n\n`goods_id` is optional. Liquidity is a weighted combination of trade-amount and trade-quantity rankings; BUFF generally considers 85% or higher to be high liquidity.", "tags": [ "Official · Market Data" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "goods_id", "in": "query", "description": "Return only this BUFF goods ID.", "required": false, "example": 43012, "schema": { "type": "integer", "minimum": 1 } }, { "name": "market_hash_name", "in": "query", "description": "Return only this Steam market hash name.", "required": false, "example": "★ Karambit | Gamma Doppler (Minimal Wear)", "schema": { "type": "string" } }, { "name": "include_sticker", "in": "query", "description": "Only takes effect when goods_id is not specified. When include_sticker is 0, the results will not include items with sealed graffiti, stickers or sticker slab, and the data will be more real-time.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "info": { "type": "array", "items": { "type": "object", "properties": { "goods_id": { "type": "integer", "description": "BUFF item ID" }, "market_hash_name": { "type": "string", "description": "Steam item name" }, "update_time": { "type": "integer", "description": "stat date update time" }, "sales": { "type": "array", "items": { "type": "object", "properties": { "liquidity_rank": { "type": "string", "description": "Pattern liquidity index percentage" }, "tag_id": { "type": "integer", "description": "BUFF pattern ID" }, "tag_name": { "type": "string", "description": "BUFF pattern name" } }, "required": [ "liquidity_rank" ] }, "description": "Liquidity index percentage" } }, "required": [ "goods_id", "market_hash_name", "update_time", "sales" ] }, "description": "Item liquidity index list" }, "stat_time": { "type": "integer", "description": "Statistics time" }, "req_remaining": { "type": "integer", "description": "Remaining call time of the API" } }, "required": [ "info", "stat_time", "req_remaining" ] }, "examples": { "1": { "summary": "Example Value", "value": { "info": [ { "goods_id": 43012, "market_hash_name": "★ Karambit | Gamma Doppler (Minimal Wear)", "update_time": 1748347800, "sales": [ { "liquidity_rank": "22.29%", "tag_id": 522195, "tag_name": "Phase2" }, { "liquidity_rank": "52.47%", "tag_id": 527680, "tag_name": "Phase4" }, { "liquidity_rank": "48.59%", "tag_id": 3204145, "tag_name": "Phase1" }, { "liquidity_rank": "99.12%", "tag_id": 3918883, "tag_name": "Phase3" } ] } ], "stat_time": 1748347800, "req_remaining": 99989 } } } } }, "headers": {}, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getEnterpriseLiquidityRanks" } }, "/api/market/enterprise/goods/sell_order": { "get": { "summary": "List sell orders for an item", "description": "Returns active sell orders for a single item.\n\n- **Access:** Enterprise API\n- **Coverage:** All items; up to 200 distinct `goods_id` values per day\n- **Updated:** Every 5 seconds\n- **Limit:** 3 requests per second\n\nOnly BUFF's fixed wear ranges are supported. Filter locally for a custom range. Wear ranges are closed intervals, such as `[0, 0.01]` and `[0.01, 0.02]`.", "tags": [ "Official · Market Data" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "market_hash_name", "in": "query", "description": "Steam market hash name for the item.", "required": true, "schema": { "type": "string" } }, { "name": "paintwear_interval", "in": "query", "description": "Fixed paint-wear interval.", "required": false, "schema": { "type": "string", "enum": [ "0.00-0.01", "0.01-0.02", "0.02-0.03", "0.03-0.04", "0.04-0.07", "0.07-0.08", "0.08-0.09", "0.09-0.10", "0.10-0.11", "0.11-0.15", "0.15-0.18", "0.18-0.21", "0.21-0.24", "0.24-0.27", "0.27-0.38", "0.38-0.39", "0.39-0.40", "0.40-0.41", "0.41-0.42", "0.42-0.45", "0.45-0.50", "0.50-0.63", "0.63-0.76", "0.76-0.90", "0.90-1.00" ] } }, { "name": "paintseed", "in": "query", "description": "Paint seed.", "required": false, "schema": { "type": "integer" } }, { "name": "paintindex", "in": "query", "description": "Paint index.", "required": false, "schema": { "type": "integer" } }, { "name": "sort_by", "in": "query", "description": " Defaults to ascending by price. The sort field and order are separated by a dot, e.g. price.asc.", "required": false, "schema": { "type": "string", "enum": [ "price.asc", "price.desc", "paintwear.asc", "paintwear.desc", "created.asc", "created.desc" ] } }, { "name": "page_num", "in": "query", "description": "Page number.", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "page_size", "in": "query", "description": "Number of results per page.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 10, "default": 10 } }, { "name": "pay_method", "in": "query", "description": "Filter orders by seller pay method, one of: epay (supporting WeChat Pay/Epay), alipay (supporting Alipay), pending_divide_balance (supporting pending divide balance)", "required": false, "schema": { "type": "string", "enum": [ "epay", "alipay", "pending_divide_balance" ] } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "allow_alipay_zft": { "type": "boolean", "description": "Is supported Alipay" }, "allow_epay": { "type": "boolean", "description": "Is supported Epay" }, "allow_pending_divide_balance": { "type": "boolean", "description": "Is supported pending divide balance" }, "force_buyer_send_offer": { "type": "boolean", "description": "Is force buyer send trade offer" }, "game": { "type": "string", "description": "Game" }, "id": { "type": "string", "description": "Bill order ID" }, "user_id": { "type": "string", "description": "User ID" }, "goods_id": { "type": "integer", "description": "Goods ID" }, "price": { "type": "string", "description": "Price, Unit: Yuan(CNY)" }, "recent_deliver_rate": { "type": "number", "format": "float", "description": "Delivery success rate (7 days)" }, "recent_average_duration": { "type": "integer", "description": "Average delivery time (7 days), in seconds" }, "description": { "type": "string" }, "sticker_premium": { "type": "integer", "description": "Sticker premium" }, "asset_info": { "$ref": "#/components/schemas/asset_info" } }, "required": [ "allow_alipay_zft", "allow_epay", "allow_pending_divide_balance", "force_buyer_send_offer", "game", "id", "user_id", "goods_id", "price", "asset_info" ] } }, "page_num": { "type": "integer" }, "page_size": { "type": "integer" }, "total_count": { "type": "integer" }, "total_page": { "type": "integer" } }, "required": [ "items", "page_num", "page_size", "total_count", "total_page" ] }, "examples": { "1": { "summary": "Example Value", "value": { "items": [ { "allow_alipay_zft": false, "allow_epay": true, "allow_pending_divide_balance": false, "asset_info": { "assetid": "31148044644", "classid": "2166291229", "contextid": 2, "goods_id": 43974, "id": "M1094535459", "info": { "fraudwarnings": null, "inspect_info": { "game_release_date": "5/9/2024", "inspect_url": "https://spect.fp.ps.netease.com/file/664455d66b026fc53bb509771Vr0gNfm05", "is_charm": false, "is_customplayer": false }, "paintindex": 455, "paintseed": 262, "stickers": [ { "category": "sticker", "market_hash_name": "Team Dignitas (Holo) | Katowice 2014", "slot": 0, "sticker_id": 53, "wear": 0 }, { "category": "sticker", "market_hash_name": "Team Dignitas (Holo) | Katowice 2014", "slot": 1, "sticker_id": 53, "wear": 0 }, { "category": "sticker", "market_hash_name": "Team Dignitas (Holo) | Katowice 2014", "slot": 2, "sticker_id": 53, "wear": 0 }, { "category": "sticker", "market_hash_name": "Team Dignitas (Holo) | Katowice 2014", "slot": 3, "sticker_id": 53, "wear": 0 } ], "tournament_tags": [ { "category": "tournamentteam", "internal_name": "team24" }, { "category": "tournament", "internal_name": "tournament3" } ] }, "instanceid": "519977179", "paintwear": "0.00220850738696754" }, "force_buyer_send_offer": false, "game": "csgo", "goods_id": 43974, "id": "1085743363-1EA0-137401908", "price": "9100", "recent_average_duration": 1290, "recent_deliver_rate": 0.5, "sticker_premium": 0, "user_id": "U1093420626" } ], "page_num": 1, "page_size": 10, "total_count": 1, "total_page": 1 } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getEnterpriseSellOrders" } }, "/api/market/developer/balance": { "get": { "summary": "Get account balance", "description": "Returns the balances available for purchases: BUFF Balance, [Margin](https://buff.163.com/user-center/asset/security_deposit/#tab=recharge), and [Authorized Alipay Balance](https://buff.163.com/user-center/asset/recharge/).\n\n- **Access:** Developer or Enterprise API\n- **Updated:** Real time\n- **Limit:** 60 requests per minute", "tags": [ "Official · Account" ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "buff_balance": { "type": "string", "description": "BUFF balance (excluding frozen amount)" }, "buff_forzen_balance": { "type": "string", "description": "BUFF frozen balance", "deprecated": true }, "buff_frozen_balance": { "type": "string", "description": "BUFF frozen balance" }, "margin_balance": { "type": "string", "description": "BUFF buy order balance (excluding frozen amount)" }, "margin_forzen_balance": { "type": "string", "description": "BUFF frozen buy order balance", "deprecated": true }, "margin_frozen_balance": { "type": "string", "description": "BUFF frozen buy order balance" }, "alipay_preauth_balance": { "type": "string", "description": "Authorized Alipay balance" } }, "required": [ "buff_balance", "buff_frozen_balance", "margin_frozen_balance", "margin_balance", "alipay_preauth_balance" ] }, "examples": { "1": { "summary": "Success example", "value": { "buff_balance": "0", "buff_frozen_balance": "0", "margin_balance": "0", "margin_frozen_balance": "0", "alipay_preauth_balance": "0" } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getBalance" } }, "/api/market/developer/buy_order/status": { "get": { "summary": "Get buy-order status settings", "description": "Returns the current buy-order status and automatic-offline settings.\n\n- **Access:** Developer or Enterprise API\n- **Updated:** Real time\n- **Limit:** 60 requests per minute", "tags": [ "Official · Buy Orders" ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "buy_order_status": { "type": "string", "description": "Buy order online/offline status", "enum": [ "online", "offline" ] }, "buy_order_auto_offline": { "type": "boolean", "description": "Auto offline" } }, "required": [ "buy_order_status", "buy_order_auto_offline" ] }, "examples": { "1": { "summary": "Success example", "value": { "buy_order_auto_offline": false, "buy_order_status": "online" } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getBuyOrderStatus" }, "put": { "summary": "Update buy-order status settings", "description": "Updates the buy-order status and automatic-offline settings.\n\n- **Access:** Developer or Enterprise API\n- **Limit:** 60 requests per minute", "tags": [ "Official · Buy Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "buy_order_status": { "type": "string", "description": "Buy order online/offline status", "enum": [ "online", "offline" ] }, "buy_order_auto_offline": { "type": "boolean", "description": "Auto offline" } }, "required": [ "buy_order_status" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": {}, "required": [] }, "examples": { "1": { "summary": "Success example", "value": {} } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "updateBuyOrderStatus" } }, "/api/market/developer/buy_order": { "get": { "summary": "List buy orders", "description": "Returns buy orders for the current BUFF account.\n\n- **Access:** Developer or Enterprise API\n- **Updated:** Real time\n- **Limit:** 60 requests per minute\n- **Maximum `page_size`:** 500\n\nAPI-created buy orders do not expire, so `expire_time` is normally `null`.", "tags": [ "Official · Buy Orders" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "order_state", "in": "query", "description": "Buy order status, progressing: in progress, success: successful, failed: canceled, waiting: waiting for payment", "required": false, "schema": { "type": "string", "enum": [ "progressing", "success", "failed", "waiting" ] } }, { "name": "start_time", "in": "query", "description": "Buy order creation start timestamp, in seconds", "required": false, "schema": { "type": "integer" } }, { "name": "end_time", "in": "query", "description": "Buy order creation end timestamp, in seconds", "required": false, "schema": { "type": "integer" } }, { "name": "steamid", "in": "query", "description": "Steam account ID to query", "required": false, "schema": { "type": "integer" } }, { "name": "page_num", "in": "query", "description": "Page number", "required": false, "schema": { "type": "integer", "default": 1 } }, { "name": "page_size", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "description": "Buy order list", "items": { "type": "object", "properties": { "buy_max_price": { "type": "string", "description": "Highest buy order price for the same item" }, "buy_order_num": { "type": "integer", "description": "Number of buy orders for the same item" }, "created_at": { "type": "integer", "description": "Buy order creation timestamp, in seconds" }, "expire_time": { "type": "integer", "description": "Buy order expiration timestamp, in seconds", "nullable": true }, "frozen_num": { "type": "integer", "description": "Quantity to be traded" }, "game": { "type": "string", "description": "Game ID" }, "goods_id": { "type": "integer", "description": "Item ID" }, "id": { "type": "string", "description": "Buy order ID" }, "num": { "type": "integer", "description": "Buy order quantity" }, "price": { "type": "string", "description": "Buy order price, in yuan" }, "real_num": { "type": "integer", "description": "Quantity already traded" }, "sell_min_price": { "type": "string", "description": "Lowest selling price for the same item" }, "specific": { "type": "array", "description": "Special buy order conditions", "items": { "type": "object", "properties": { "simple_text": { "type": "string", "description": "Display text" }, "type": { "type": "string", "description": "Special buy order type", "enum": [ "unlock_style", "paintwear", "fade" ] }, "value": { "type": "array", "description": "Special buy order value", "items": { "oneOf": [ { "type": "string" }, { "type": "integer" } ] } } }, "required": [ "simple_text", "type", "value" ] } }, "state": { "type": "string", "description": "Buy order status", "enum": [ "progressing", "success", "failed", "waiting" ] }, "steamid_text": { "type": "string", "description": "Steam account information, format: SteamID(username)" } } } }, "page_num": { "type": "integer", "description": "Page number." }, "page_size": { "type": "integer", "description": "Number of results per page." }, "total_count": { "type": "integer", "description": "Total count" }, "total_page": { "type": "integer", "description": "Total page" } }, "required": [ "items", "page_num", "page_size", "total_count", "total_page" ] }, "examples": { "1": { "summary": "Success example", "value": { "items": [ { "buy_max_price": "10", "buy_order_num": 1, "created_at": 1754379229, "expire_time": null, "frozen_num": 0, "game": "csgo", "goods_id": 47427, "id": "250805T1093434037", "num": 1, "price": "10", "real_num": 0, "sell_min_price": "0", "specific": [], "state": "progressing", "steamid_text": "88888888888888888(username)" }, { "buy_max_price": "0", "buy_order_num": 0, "created_at": 1747984960, "expire_time": 1750576970, "frozen_num": 0, "game": "csgo", "goods_id": 218562, "id": "250523T1093434308", "num": 1, "price": "1", "real_num": 0, "sell_min_price": "0.16", "specific": [], "state": "progressing", "steamid_text": "88888888888888888(username)" } ], "page_num": 1, "page_size": 10, "total_count": 2, "total_page": 1 } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "listBuyOrders" }, "post": { "summary": "Create buy orders", "description": "Creates buy orders for the current BUFF account. The receiving Steam account must be bound to that BUFF account. See [buy-order style values](https://buff.163.com/help#API_buy_order_style).\n\n- **Access:** Developer or Enterprise API\n- **Per-item limit:** 1 request per minute, 3 per hour, and 10 per day for each `goods_id`\n\nAPI-created buy orders use pay-after-supply and do not support EPay or WeChat Pay. Payment can use BUFF Balance, [Margin](https://buff.163.com/user-center/asset/security_deposit/#tab=recharge), or [Authorized Alipay Balance](https://buff.163.com/user-center/asset/recharge/). Margin expires after 150 days and is refunded to the associated bank card. BUFF cancels buy orders when BUFF Balance plus Buy Order Funds is below the order amount.", "tags": [ "Official · Buy Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game ID", "enum": [ "cs2" ] }, "goods_id": { "type": "integer", "description": "Item ID", "example": 47427 }, "price": { "type": "string", "description": "Buy order price, in yuan", "example": "100" }, "num": { "type": "integer", "description": "Buy order quantity", "example": 1 }, "specific": { "type": "array", "description": "Special buy order conditions", "items": { "type": "object", "properties": { "specific_type": { "type": "string", "description": "Special buy order type", "enum": [ "unlock_style", "min_paintwear", "max_paintwear", "min_fade" ] }, "value": { "type": "string", "description": "special buy order type ID" } }, "required": [ "specific_type", "value" ] }, "example": [ { "specific_type": "min_paintwear", "value": "0.07" }, { "specific_type": "max_paintwear", "value": "0.08" }, { "specific_type": "min_fade", "value": "94" }, { "specific_type": "unlock_style", "value": "Phase3" } ], "x-hide": true }, "steamid": { "type": "integer", "description": "Steam account for buy order", "example": 88888888888 } }, "required": [ "game", "goods_id", "price", "num" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "buy_order_id": { "type": "string", "description": "Buy order ID", "example": "250805T1093434037" } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "createBuyOrders" }, "delete": { "summary": "Cancel buy orders", "description": "Cancels buy orders for the current BUFF account.\n\n- **Access:** Developer or Enterprise API\n- **Limit:** None documented", "tags": [ "Official · Buy Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game ID", "enum": [ "cs2" ] }, "buy_order_ids": { "type": "array", "description": "List of buy order IDs", "items": { "type": "string" }, "example": [ "250805T1093434037", "250805T1093434038", "250805T1093434039" ] } }, "required": [ "game", "buy_order_ids" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string", "description": "Buy order processing result" } }, "examples": { "1": { "summary": "Success example", "value": { "250805T1093434037": "OK", "250805T1093434038": "OK", "250805T1093434039": "Error message" } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "cancelBuyOrders" } }, "/api/market/developer/sell_order/on_sale": { "get": { "summary": "List items on sale", "description": "Returns items currently listed for sale by the current BUFF account.", "tags": [ "Official · Sell Orders" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "steamid", "in": "query", "required": false, "description": "Filter by a Steam ID linked to the current BUFF account.", "schema": { "type": "string" } }, { "name": "min_price", "in": "query", "required": false, "description": "Minimum price (yuan, up to 2 decimal places)", "schema": { "type": "number", "minimum": 0 } }, { "name": "max_price", "in": "query", "required": false, "description": "Maximum price (yuan, up to 2 decimal places)", "schema": { "type": "number" } }, { "name": "min_paintwear", "in": "query", "required": false, "description": "Minimum paintwear", "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "max_paintwear", "in": "query", "required": false, "description": "Maximum paintwear", "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "search", "in": "query", "required": false, "description": "Fuzzy search by item name", "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "required": false, "description": "Sort order", "schema": { "type": "string", "enum": [ "price.asc", "price.desc", "updated.asc", "updated.desc", "paintwear.asc", "paintwear.desc", "float.asc", "float.desc" ] } }, { "name": "page_num", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "default": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "Items per page", "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "On-sale order list", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "description": "Status code", "example": 200 }, "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object" }, "example": [ { "allow_alipay_zft": true, "allow_epay": true, "allow_pending_divide_balance": false, "asset_info": { "assetid": "10000000001", "classid": "7104639705", "contextid": 2, "goods_id": 1116856, "id": "M1000000001", "info": { "fraudwarnings": null, "icon_url": "https://example.com/icon.png", "inspect_info": {}, "keychains": [], "original_icon_url": "https://example.com/original_icon.png", "paintindex": null, "paintseed": null, "stickers": [], "tournament_tags": [ { "category": "tournament", "internal_name": "tournament24" }, { "category": "tournamentteam", "internal_name": "team134" }, { "category": "proplayer", "internal_name": "wicadia" } ] }, "instanceid": "188530139", "paintwear": "" }, "can_bargain": true, "can_bargain_swap": true, "cannot_bargain_reason": "", "description": "", "force_buyer_send_offer": false, "game": "csgo", "goods_id": 1116856, "id": "4037514739-B011-152464129", "price": "0.02", "recent_average_duration": null, "recent_deliver_rate": null, "sticker_premium": null, "user_id": "U1000000001" } ] }, "total_count": { "type": "integer", "example": 42 }, "page_num": { "type": "integer", "example": 1 }, "page_size": { "type": "integer", "example": 50 }, "total_page": { "type": "integer", "example": 1 } } } } } } } } }, "security": [ { "bearer": [] } ], "operationId": "listSellOrders" } }, "/api/market/developer/sell_order/history": { "post": { "summary": "List sell orders", "description": "Returns sell orders in any state for the current BUFF account.\n\n- **Limit:** 10 requests per second", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "order_ids": { "type": "array", "description": "Order ID list, up to 30 items", "items": { "type": "string", "description": "Order ID" }, "maxItems": 30 }, "steamid": { "type": "string", "description": "SteamID, filter by seller's SteamID" }, "order_state": { "type": "string", "description": "Order status", "enum": [ "PAYING", "TO_DELIVER", "DELIVERING", "SUCCESS", "FAIL" ] }, "page_num": { "type": "integer", "description": "Page number", "minimum": 1, "default": 1 }, "page_size": { "type": "integer", "description": "Number of results per page.", "minimum": 1, "maximum": 500, "default": 10 }, "start_time": { "type": "integer", "description": "Order creation start timestamp in seconds" }, "end_time": { "type": "integer", "description": "Order creation end timestamp in seconds" } }, "required": [ "game" ] }, "example": { "game": "cs2" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "description": "Order list", "items": { "type": "object", "properties": { "asset_info": { "$ref": "#/components/schemas/asset_info" }, "sell_order_id": { "type": "string", "description": "Associated sell order ID", "example": "1085743363-1EA0-137401908" }, "seller_send_offer": { "type": "boolean", "description": "Whether the seller sends the offer", "example": true }, "seller_steamid": { "type": "string", "description": "Seller SteamID", "example": "76561198099941084" }, "created_at": { "type": "integer", "description": "Creation timestamp", "example": 1761212487 }, "fee": { "type": "string", "description": "Fee", "example": "1.25" }, "game": { "type": "string", "description": "Game", "example": "csgo" }, "goods_id": { "type": "integer", "description": "Goods ID", "example": 209976 }, "id": { "type": "string", "description": "Order ID", "example": "251023T1093498143" }, "price": { "type": "string", "description": "Price", "example": "50" }, "state": { "type": "string", "description": "Order status", "enum": [ "PAYING", "TO_DELIVER", "DELIVERING", "SUCCESS", "FAIL" ] }, "state_text": { "type": "string", "description": "Order status text", "example": "出售成功" }, "type": { "type": "integer", "description": "Order type, 1:Standard order, 2:Buy order, 3:Matching order, 5:Auction order, 6:Pre-sale order", "example": 1 }, "tradeofferid": { "type": "string", "description": "Steam trade offer id", "example": "8607313592" }, "trade_offer_status": { "type": "string", "description": "Steam trade offer status, only present when tradeofferid is returned. Values: trading/success/fail/rollback/finish", "enum": [ "trading", "success", "fail", "rollback", "finish" ] }, "rollback_by": { "type": "string", "description": "Rollback initiator, only present when trade_offer_status is rollback. buyer/seller", "enum": [ "buyer", "seller" ] }, "updated_at": { "type": "integer", "description": "Update timestamp", "example": 1761212487 } }, "required": [ "asset_info", "seller_steamid", "created_at", "fee", "game", "goods_id", "id", "price", "state", "state_text", "type", "updated_at" ] } }, "page_num": { "type": "integer", "description": "Current page number", "example": 1 }, "page_size": { "type": "integer", "description": "Number of results per page.", "example": 10 }, "total_count": { "type": "integer", "description": "Total count", "example": 3 }, "total_page": { "type": "integer", "description": "Total pages", "example": 1 } }, "required": [ "items", "page_num", "page_size", "total_count", "total_page" ] } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "listSellOrderHistory" } }, "/api/market/developer/sell_order/send_offer": { "post": { "summary": "Send a seller-initiated trade offer", "description": "Creates a Steam trade offer for a sell order in the `SELLER_TO_SEND_OFFER` state.\n\nThe seller must first upload valid Steam cookies with the Steam setup or cookie endpoint.", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "order_id": { "type": "string", "description": "Sell order ID", "example": "250805T1093434037" } }, "required": [ "order_id" ] } } } }, "responses": { "200": { "description": "Offer sent successfully" }, "403": { "description": "Order does not belong to current user or steamid not bound" }, "404": { "description": "Order not found" } }, "security": [ { "bearer": [] } ], "operationId": "sendSellOffer" } }, "/api/market/developer/sell_order/accept_offer": { "post": { "summary": "Accept a buyer-initiated trade offer", "description": "Accepts the Steam trade offer sent by the buyer.\n\nThe seller must first upload valid Steam cookies with the Steam setup or cookie endpoint.", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "order_id": { "type": "string", "description": "Sell order ID", "example": "250805T1093434037" } }, "required": [ "order_id" ] } } } }, "responses": { "200": { "description": "Offer accepted successfully" }, "400": { "description": "Order has no trade offer" }, "403": { "description": "Order does not belong to current user" }, "404": { "description": "Order not found" }, "422": { "description": "Accept trade offer failed (invalid trade offer or Steam error)" } }, "security": [ { "bearer": [] } ], "operationId": "acceptBuyOffer" } }, "/api/market/developer/sell_order/refresh": { "post": { "summary": "Refresh sell-order status", "description": "Uploads the seller's Steam session cookie and refreshes stuck or reversed sell orders.\n\n- **Limit:** 60 requests per minute", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "order_ids": { "type": "array", "description": "Order ID list, 1-30 items", "items": { "type": "string", "description": "Order ID" }, "minItems": 1, "maxItems": 30 }, "steam_cookies": { "type": "string", "description": "Steam session cookie (JSON format string)" } }, "required": [ "order_ids", "steam_cookies" ] }, "example": { "order_ids": [ "250623T1093492961", "251023T1093498142", "251023T1093498143" ], "steam_cookies": "[{\"domain\":\"steamcommunity.com\",\"key\":\"steamLoginSecure\",\"value\":\"76561198012345678%7C%7C*****\"},{\"domain\":\"login.steampowered.com\",\"key\":\"steamRefresh_steam\",\"value\":\"*****\"},{\"domain\":\"login.steampowered.com\",\"key\":\"ak_bmsc\",\"value\":\"*****\"},{\"domain\":\"login.steampowered.com\",\"key\":\"bm_sv\",\"value\":\"*****\"}]" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "description": "Order refresh results, keys are order IDs, values are operation status", "additionalProperties": { "type": "string", "description": "Order refresh status" } }, "examples": { "1": { "summary": "Example Value", "value": { "250623T1093492961": "success", "251023T1093498142": "trade not exist", "251023T1093498143": "trade not success" } } } } }, "description": "Successful response." }, "400": { "description": "Orders not found or do not belong to the same Steam account" }, "403": { "description": "Order does not belong to current user" } }, "security": [ { "bearer": [] } ], "operationId": "refreshSellOrders" } }, "/api/market/developer/steam/inventory": { "get": { "summary": "List Steam inventory items", "description": "Returns inventory items from a Steam account bound to the current BUFF account. See [CS2 inventory filters](https://buff.163.com/help#API_inventory_filters).\n\n- **Limit:** 60 requests per minute\n\n`steamid` must identify a Steam account bound to the current BUFF account. Set `force=1` to refresh the inventory with the stored Steam session cookie. Update an invalid cookie with `POST /api/market/developer/steam/cookie`.", "tags": [ "Official · Sell Orders" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "steamid", "in": "query", "description": "Steam 64-bit ID, required. Must be bound to the current user.", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number, optional.", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "page_size", "in": "query", "description": "Items per page, optional.", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "force", "in": "query", "description": "Force refresh inventory", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 0 } }, { "name": "search", "in": "query", "description": "Fuzzy search by name or market hash name", "required": false, "schema": { "type": "string" } }, { "name": "min_price", "in": "query", "description": "Minimum reference price (yuan, up to 2 decimal places)", "required": false, "example": 10.01, "schema": { "type": "number", "minimum": 0 } }, { "name": "max_price", "in": "query", "description": "Maximum reference price (yuan, up to 2 decimal places)", "required": false, "example": 100.5, "schema": { "type": "number", "minimum": 0 } }, { "name": "min_paintwear", "in": "query", "description": "Minimum paintwear of items", "required": false, "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "max_paintwear", "in": "query", "description": "Maximum paintwear of items", "required": false, "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "sort_by", "in": "query", "description": "Sort: Defaults to descending by time. The sort field and order are separated by a dot, e.g. time.desc", "required": false, "schema": { "type": "string", "enum": [ "time.asc", "time.desc", "price.asc", "price.desc", "paintwear.asc", "paintwear.desc", "float.asc", "float.desc" ] } }, { "name": "state", "in": "query", "description": "Inventory state: all; tradable; cansell; onsale", "required": false, "schema": { "type": "string", "enum": [ "all", "tradable", "cansell", "onsale" ] } }, { "name": "name_tag", "in": "query", "description": "Has nametag. 0: all; 1: nametag only", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } } ], "responses": { "200": { "description": "Inventory item list", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "description": "Inventory item list", "items": { "type": "object", "properties": { "appid": { "type": "integer", "description": "Game ID", "example": 730 }, "game": { "type": "string", "description": "Game abbreviation", "example": "csgo" }, "assetid": { "type": "string", "description": "Steam asset ID", "example": "51073537258" }, "market_hash_name": { "type": "string", "description": "Steam item market hash name", "example": "Nova | Mandrel (Field-Tested)" }, "goods_id": { "type": "integer", "description": "BUFF goods ID", "example": 58835 }, "steam_price": { "type": "string", "description": "Reference price (CNY), based on the user's inventory price display setting, default is Steam market price", "example": "0.03" }, "sell_min_price": { "type": "string", "description": "BUFF lowest listing price (CNY)", "example": "400" }, "buy_max_price": { "type": "string", "description": "BUFF highest buy order price (CNY)", "example": "0" }, "tradable": { "type": "boolean", "description": "Whether the item is tradable", "example": true }, "tradable_time": { "type": "integer", "description": "Tradable after (Unix timestamp, seconds). null means already tradable or not in cooldown", "example": null, "nullable": true }, "state": { "type": "integer", "description": "Inventory state code. 1:tradable, 3:sellable on BUFF, 4:untradable", "example": 3 }, "state_text": { "type": "string", "description": "Inventory state text", "example": "Sellable" }, "asset_info": { "$ref": "#/components/schemas/asset_info" } } } }, "total_count": { "type": "integer", "description": "Total inventory count", "example": 42 }, "page_num": { "type": "integer", "description": "Current page number", "example": 1 }, "page_size": { "type": "integer", "description": "Items per page", "example": 20 } } } } } } }, "security": [ { "bearer": [] } ], "operationId": "getSteamInventory" } }, "/api/market/developer/sell_order/items": { "post": { "summary": "List inventory items for sale", "description": "Lists up to 200 inventory items for sale in one request.", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "steamid": { "type": "string", "description": "Steam ID. Defaults to the primary steam account." }, "assets": { "type": "array", "description": "Asset list, required. Min 1, max 200 items.", "minItems": 1, "maxItems": 200, "items": { "type": "object", "properties": { "assetid": { "type": "string", "description": "Asset ID, required." }, "price": { "type": "number", "description": "Listing price (CNY). " }, "desc": { "type": "string", "description": "Description, optional, max 40 characters.", "maxLength": 40 } }, "required": [ "assetid", "price" ] } } }, "required": [ "game", "assets" ] } } } }, "responses": { "200": { "description": "Sell orders created. Returns a map keyed by assetid — value is \"OK\" on success, or error message on failure.", "content": { "application/json": { "schema": { "type": "object", "description": "Result map keyed by assetid. Value is \"OK\" on success, error message string on failure. The sell_orders field is returned only when at least one order is created successfully.", "properties": { "sell_orders": { "type": "object", "description": "Details of successfully created sell orders, keyed by assetid. Only present when at least one order is created successfully.", "additionalProperties": { "type": "object", "properties": { "sell_order_id": { "type": "string", "description": "Created sell order ID." } } } } }, "additionalProperties": { "type": "string" }, "example": { "47939361799": "OK", "sell_orders": { "47939361799": { "sell_order_id": "1085743363-1EA0-137401908" } } } } } } }, "400": { "description": "Parameter error (invalid price, etc.)" }, "422": { "description": "Business error (on-sale limit exceeded, asset not found, asset already on sale, etc.)" } }, "security": [ { "bearer": [] } ], "operationId": "listInventoryItems" }, "delete": { "summary": "Remove items from sale", "description": "Removes up to 50 currently listed items from sale in one request.", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "sell_orders": { "type": "array", "description": "List of sell order format_ids, required. 1-50 items.", "minItems": 1, "maxItems": 50, "items": { "type": "string" }, "example": [ "1085238058-19A0-137401140", "1085238058-19A0-137401141" ] } }, "required": [ "game", "sell_orders" ] } } } }, "responses": { "200": { "description": "Cancel result. Key is sell_order_id, value is \"OK\" on success or error message.", "content": { "application/json": { "schema": { "type": "object", "description": "Result mapping with sell_order_id as key", "additionalProperties": { "type": "string" }, "example": { "1085238058-19A0-137401140": "OK" } } } } }, "400": { "description": "Parameter error (empty sell_orders, more than 50 items, etc.)" }, "422": { "description": "Business error (sell order status does not allow cancellation, etc.)" } }, "security": [ { "bearer": [] } ], "operationId": "unlistSellOrders" }, "put": { "summary": "Update sale prices", "description": "Updates the prices of up to 200 currently listed items in one request.", "tags": [ "Official · Sell Orders" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "sell_orders": { "type": "array", "description": "Sell orders to update, required. Min 1, max 200 items.", "minItems": 1, "maxItems": 200, "items": { "type": "object", "properties": { "sell_order_id": { "type": "string", "description": "Sell order format_id, required." }, "price": { "type": "number", "description": "New price (CNY, up to 2 decimal places)." }, "desc": { "type": "string", "description": "Description, optional, max 40 characters.", "maxLength": 40 } }, "required": [ "sell_order_id", "price" ] } } }, "required": [ "game", "sell_orders" ] } } } }, "responses": { "200": { "description": "Price changed. Returns a map keyed by sell order format_id — value is \"OK\" on success, or error message on failure.", "content": { "application/json": { "schema": { "type": "object", "description": "Result map keyed by sell order format_id. Value is \"OK\" on success, error message string on failure.", "additionalProperties": { "type": "string" }, "example": { "SO-20260429-XXXXX": "OK" } } } } }, "403": { "description": "Sell order does not belong to current user" }, "422": { "description": "Business error (sell order status does not allow price change, unreasonable price, etc.)" } }, "security": [ { "bearer": [] } ], "operationId": "updateSellOrderPrices" } }, "/api/market/developer/purchase/quantity": { "get": { "summary": "Get standard-item availability", "description": "Returns the number of standard items available for bulk purchase or gifting.\n\n- **Standard items:** Stickers, weapon cases, music kits, tools, sprays, passes, collectibles, patches, and gifts\n- **Limit:** 60 requests per minute\n\nItems whose trade offers must be created by the buyer are excluded. When both `market_hash_name` and `goods_id` are supplied, `goods_id` takes precedence.", "tags": [ "Official · Purchases" ], "parameters": [ { "name": "game", "in": "query", "description": "Game identifier.", "required": true, "schema": { "type": "string", "enum": [ "cs2" ] } }, { "name": "goods_id", "in": "query", "description": "Single goods ID", "example": 38150, "schema": { "type": "integer" } }, { "name": "market_hash_name", "in": "query", "description": "Steam market hash name.", "example": "Spectrum Case", "schema": { "type": "string" } }, { "name": "max_price", "in": "query", "description": "Maximum price for orders on sale", "required": false, "schema": { "type": "number", "minimum": 0 } }, { "name": "pay_method", "in": "query", "description": "Payment method filter: alipay (orders supporting alipay), bankcard (orders supporting bankcard). ", "required": false, "schema": { "type": "string", "enum": [ "alipay", "bankcard" ] } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "quantity": { "type": "integer", "description": "Quantity of orders on sale", "example": 20 } }, "required": [ "quantity" ] } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "getPurchaseQuantity" } }, "/api/market/developer/purchase/orders": { "post": { "summary": "Purchase or gift standard items", "description": "Purchases or gifts standard items in batches using an item, maximum price, and recipient trade URL.\n\n- **Standard items:** Stickers, weapon cases, music kits, tools, sprays, passes, collectibles, patches, and gifts\n- **Per-request limit:** 20 `goods_id` values and 200 items per `goods_id`\n\nIf `pay_method` is omitted, BUFF uses funds in this order: BUFF Balance, [Margin](https://buff.163.com/user-center/asset/security_deposit/#tab=recharge), then [Authorized Alipay Balance](https://buff.163.com/user-center/asset/recharge/). Only items whose offers are created by sellers are supported. `goods_id` takes precedence over `market_hash_name`; `trade_url` takes precedence over `steamid`. If `trade_url` is omitted, BUFF uses the first trade link bound to the current account.", "tags": [ "Official · Purchases" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "steamid": { "type": "string", "description": "The Steam ID bound to the user's account.", "example": "88888888888" }, "trade_url": { "type": "string", "description": "A custom trade URL (does not need to belong to the user). When provided, the steamid parameter will be overridden by the Steam ID extracted from this trade URL.", "example": "https://steamcommunity.com/tradeoffer/new/?partner=ddddddddd&token=xxxxxxxx" }, "pay_method": { "type": "string", "description": "Specify payment method: balance (BUFF balance), security (margin), alipay (authorized alipay balance). If not specified, auto-select by priority: BUFF balance > margin > authorized alipay balance.", "enum": [ "balance", "security", "alipay" ] }, "items": { "type": "array", "description": "Purchase item information", "items": { "type": "object", "properties": { "goods_id": { "type": "integer", "description": "Goods id" }, "market_hash_name": { "type": "string", "description": "Goods market_hash_name" }, "max_price": { "type": "number", "description": "Maximum purchase price", "minimum": 0 }, "quantity": { "type": "integer", "description": "Purchase quantity", "default": 1 } }, "required": [ "max_price" ] }, "example": [ { "goods_id": 209976, "max_price": 100, "quantity": 1 }, { "goods_id": 209978, "max_price": 100, "quantity": 1 } ] } }, "required": [ "game", "items" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "result": { "type": "object", "description": "Keys are goods IDs, values are purchase results for each goods", "additionalProperties": { "type": "object", "properties": { "success_num": { "type": "integer", "description": "Purchase quantity" }, "total_cost": { "type": "number", "description": "Purchase cost" }, "bill_order_ids": { "type": "array", "description": "Bill order ids", "items": { "type": "string" } }, "error": { "type": "string", "description": "Purchase error message" } }, "required": [ "success_num", "total_cost", "bill_order_ids" ] } }, "buff_balance": { "type": "number", "description": "BUFF balance" }, "margin_balance": { "type": "number", "description": "Margin balance" } }, "required": [ "result", "buff_balance" ] }, "examples": { "1": { "summary": "Example Value", "value": { "result": { "38150": { "success_num": 1, "total_cost": 26, "bill_order_ids": [ "250805T1093434039" ] }, "35893": { "success_num": 4, "total_cost": 119.2, "bill_order_ids": [ "250805T1093434040", "250805T1093434041", "250805T1093434042", "250805T1093434043" ] } }, "buff_balance": 1234.56 } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "createPurchaseOrders" }, "delete": { "summary": "Cancel purchase orders", "description": "Cancels purchase orders that have waited at least 30 minutes for seller delivery.", "tags": [ "Official · Purchases" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "order_ids": { "type": "array", "description": "Purchase order ID list", "items": { "type": "string" }, "example": [ "250805T1093434037", "250805T1093434038", "250805T1093434039" ] } }, "required": [ "game", "order_ids" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "success_list": { "type": "array", "description": "Successfully cancelled order IDs", "items": { "type": "string", "description": "Order ID", "example": "250623T1093492961" }, "minItems": 0 }, "error_list": { "type": "object", "description": "Failed cancelled orders with reasons", "additionalProperties": { "type": "string", "description": "Failure reason" } } }, "required": [ "success_list", "error_list" ] }, "examples": { "1": { "summary": "Example Value", "value": { "success_list": [ "250805T1093434037", "250805T1093434038" ], "error_list": { "250805T1093434039": "该交易订单异常，请联系客服处理", "250805T1093434040": "该订单无法被取消, 请等待卖家发货" } } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "cancelPurchaseOrders" } }, "/api/market/developer/purchase/orders/list": { "post": { "summary": "List purchase orders", "description": "Returns purchase orders in any state for the current BUFF account.\n\n- **Limit:** 10 requests per second\n\nAfter BUFF creates a Steam trade offer, the response includes `tradeofferid`, the Steam offer ID.", "tags": [ "Official · Purchases" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "game": { "type": "string", "description": "Game identifier.", "enum": [ "cs2" ] }, "order_ids": { "type": "array", "description": "Order ID list, up to 30 items", "items": { "type": "string", "description": "Order ID", "example": "250805T1093434037" }, "maxItems": 30 }, "steamid": { "type": "string", "description": "SteamID (optional)", "example": "76561198000000000" }, "order_state": { "type": "string", "description": "Order status (optional)", "enum": [ "PAYING", "TO_DELIVER", "DELIVERING", "SUCCESS", "FAIL" ] }, "page_num": { "type": "integer", "description": "Page number (optional)", "minimum": 1, "default": 1 }, "page_size": { "type": "integer", "description": "Page size (optional)", "minimum": 1, "maximum": 500, "default": 10 }, "start_time": { "type": "integer", "description": "Order creation start timestamp in seconds", "example": 1700000000 }, "end_time": { "type": "integer", "description": "Order creation end timestamp in seconds", "example": 1700086400 } }, "required": [ "game" ] }, "example": { "game": "cs2" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "description": "Order list", "items": { "type": "object", "properties": { "asset_info": { "$ref": "#/components/schemas/asset_info" }, "buy_order_id": { "type": "string", "description": "Associated buy order ID, only available for orders triggered by buy orders", "example": "250115T1093456789" }, "buyer_steamid": { "type": "string", "description": "Buyer SteamID", "example": "76561198099941084" }, "created_at": { "type": "integer", "description": "Creation timestamp", "example": 1761212487 }, "fee": { "type": "string", "description": "Fee", "example": "1.25" }, "game": { "type": "string", "description": "Game", "example": "csgo" }, "goods_id": { "type": "integer", "description": "Goods ID", "example": 209976 }, "id": { "type": "string", "description": "Order ID", "example": "251023T1093498143" }, "price": { "type": "string", "description": "Price", "example": "50" }, "seller_send_offer": { "type": "boolean", "description": "Seller send offer", "example": true }, "state": { "type": "string", "description": "Order status", "enum": [ "PAYING", "TO_DELIVER", "DELIVERING", "SUCCESS", "FAIL" ] }, "state_text": { "type": "string", "description": "Order status text", "example": "购买成功" }, "type": { "type": "integer", "description": "Order type, 1:Standard order, 2:Buy order, 3:Matching order, 5:Auction order, 6:Pre-sale order", "example": 1 }, "tradeofferid": { "type": "string", "description": "Steam trade offer id", "example": "8607313592" }, "trade_offer_status": { "type": "string", "description": "Steam trade offer status, only present when tradeofferid is returned. Values: trading/success/fail/rollback/finish", "enum": [ "trading", "success", "fail", "rollback", "finish" ] }, "rollback_by": { "type": "string", "description": "Rollback initiator, only present when trade_offer_status is rollback. buyer/seller", "enum": [ "buyer", "seller" ] }, "updated_at": { "type": "integer", "description": "Update timestamp", "example": 1761212487 } }, "required": [ "asset_info", "buyer_steamid", "created_at", "fee", "game", "goods_id", "id", "price", "seller_send_offer", "state", "state_text", "type", "updated_at" ] } }, "page_num": { "type": "integer", "description": "Current page number", "example": 1 }, "page_size": { "type": "integer", "description": "Number of results per page.", "example": 10 }, "total_count": { "type": "integer", "description": "Total count", "example": 3 }, "total_page": { "type": "integer", "description": "Total pages", "example": 1 } }, "required": [ "items", "page_num", "page_size", "total_count", "total_page" ] }, "examples": { "1": { "summary": "Example Value", "value": { "items": [ { "asset_info": { "assetid": "47945928824", "classid": "310776573", "contextid": 2, "goods_id": 209976, "id": "M6362486318", "instanceid": "7758141006", "paintwear": "0.3657386302947998", "info": { "fraudwarnings": null, "inspect_info": {}, "keychains": [], "paintindex": 148, "paintseed": 512, "stickers": [], "tournament_tags": [] } }, "buy_order_id": "260121T1093434043", "buyer_steamid": "76561198099941084", "created_at": 1761212487, "fee": "1.25", "game": "csgo", "goods_id": 209976, "id": "251023T1093498143", "price": "50", "seller_send_offer": true, "state": "SUCCESS", "state_text": "购买成功", "tradeofferid": "8607313592", "trade_offer_status": "success", "type": 1, "updated_at": 1761212673 }, { "asset_info": { "assetid": "47945928825", "classid": "310776573", "contextid": 2, "goods_id": 209976, "id": "M6362486319", "instanceid": "7758141007", "paintwear": "0.2145678901234567", "info": { "fraudwarnings": null, "inspect_info": {}, "keychains": [], "paintindex": 148, "paintseed": 256, "stickers": [], "tournament_tags": [] } }, "buyer_steamid": "76561198099941084", "created_at": 1761212439, "fee": "1.25", "game": "csgo", "goods_id": 209976, "id": "251023T1093498142", "price": "49.9", "seller_send_offer": true, "state": "PAYING", "state_text": "订单状态确认中", "tradeofferid": "8607313593", "trade_offer_status": "trading", "type": 1, "updated_at": 1761212726 }, { "asset_info": { "assetid": "47945928826", "classid": "310776574", "contextid": 2, "goods_id": 44443, "id": "M6362486320", "instanceid": "7758141008", "paintwear": "0.0876543210987654", "info": { "fraudwarnings": null, "inspect_info": {}, "keychains": [], "paintindex": 455, "paintseed": 128, "stickers": [], "tournament_tags": [] } }, "buyer_steamid": "76561198099941084", "created_at": 1750671583, "fee": "1.15", "game": "csgo", "goods_id": 44443, "id": "250623T1093492961", "price": "46", "seller_send_offer": true, "state": "FAIL", "state_text": "购买失败-已退款", "type": 1, "updated_at": 1750671867 } ], "page_num": 1, "page_size": 10, "total_count": 3, "total_page": 1 } } } } }, "description": "Successful response." } }, "security": [ { "bearer": [] } ], "operationId": "listPurchaseOrders" } }, "/api/market/developer/steam": { "get": { "summary": "List bound Steam accounts", "description": "Returns the Steam accounts bound to the current BUFF account and the account’s maximum number of binding slots.", "tags": [ "Official · Account" ], "parameters": [ { "name": "page_num", "in": "query", "description": "Page number", "required": false, "schema": { "type": "integer", "default": 1, "minimum": 1 } }, { "name": "page_size", "in": "query", "description": "Items per page", "required": false, "schema": { "type": "integer", "default": 10, "minimum": 1, "maximum": 100 } } ], "responses": { "200": { "description": "Query successful", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "description": "Steam account list", "items": { "type": "object", "properties": { "steamid": { "type": "string", "description": "Steam account ID", "example": "76561198012345678" } } } }, "total_count": { "type": "integer", "description": "Total bound count", "example": 1 }, "page_num": { "type": "integer", "description": "Current page number", "example": 1 }, "page_size": { "type": "integer", "description": "Items per page", "example": 10 }, "total_page": { "type": "integer", "description": "Total pages", "example": 1 }, "max_bind_count": { "type": "integer", "description": "Maximum bind count", "example": 2 } } } } } }, "400": { "description": "Parameter error (page_num < 1 or page_size out of range)" }, "403": { "description": "Authentication failed (invalid token, missing permission, IP whitelist restriction)" }, "500": { "description": "System error" } }, "security": [ { "bearer": [] } ], "operationId": "listSteamAccounts" } }, "/api/market/developer/steam/setup": { "post": { "summary": "Set up a bound Steam account", "description": "Makes a bound Steam account's inventory public and sets its Steam trade link.\n\nThe Steam account must already be bound to BUFF. Each setup action reports its result independently; one failure does not prevent the others from running.", "tags": [ "Official · Account" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "steamid": { "type": "string", "description": "Steam account ID", "example": "76561198012345678" } }, "required": [ "steamid" ] } } } }, "responses": { "200": { "description": "Setup result", "content": { "application/json": { "schema": { "type": "object", "properties": { "publish_inventory": { "type": "string", "description": "Publish inventory result", "enum": [ "success", "fail" ] }, "setup_trade_url": { "type": "string", "description": "Setup trade URL result", "enum": [ "success", "fail" ] }, "setup_api_key": { "type": "string", "description": "Setup API Key result", "enum": [ "success", "fail" ] }, "errors": { "type": "object", "description": "Error messages for failed operations", "additionalProperties": { "type": "string" } } } }, "example": { "publish_inventory": "success", "setup_trade_url": "success", "setup_api_key": "fail", "errors": { "setup_api_key": "Need manual set API key" } } } } }, "400": { "description": "Parameter error (steamid not bound to current user)" }, "422": { "description": "Business error (Cookie not found or expired)" } }, "security": [ { "bearer": [] } ], "operationId": "setupSteamAccount" } }, "/api/market/developer/steam/cookie": { "post": { "summary": "Update Steam cookies", "description": "Updates the Steam session cookies for an account bound to the current BUFF account.", "tags": [ "Official · Account" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "steamid": { "type": "string", "description": "Steam account ID", "example": "76561198012345678" }, "steam_cookies": { "type": "string", "description": "Steam Cookie JSON", "example": "[{\"domain\":\"steamcommunity.com\",\"key\":\"steamLoginSecure\",\"value\":\"76561198012345678%7C%7C*****\"},{\"domain\":\"login.steampowered.com\",\"key\":\"steamRefresh_steam\",\"value\":\"*****\"},{\"domain\":\"login.steampowered.com\",\"key\":\"ak_bmsc\",\"value\":\"*****\"},{\"domain\":\"login.steampowered.com\",\"key\":\"bm_sv\",\"value\":\"*****\"}]" } }, "required": [ "steamid", "steam_cookies" ] } } } }, "responses": { "200": { "description": "Refresh successful", "content": { "application/json": { "schema": { "type": "object", "properties": { "steamid": { "type": "string", "description": "Steam account ID", "example": "76561198012345678" }, "cookie_state": { "type": "string", "description": "Cookie state", "enum": [ "valid" ] } } } } } }, "400": { "description": "Parameter error (steamid not bound to current user, invalid Cookie format, steamLoginSecure mismatch)" } }, "security": [ { "bearer": [] } ], "operationId": "updateSteamCookies" } }, "/api/market/developer/shop/status": { "get": { "summary": "Get shop status", "description": "Returns the current account's shop status.\n\n- **Limit:** 60 requests per minute", "tags": [ "Official · Account" ], "responses": { "200": { "description": "Shop status info", "content": { "application/json": { "schema": { "type": "object", "properties": { "shop_name": { "type": "string", "description": "Shop name", "example": "My Shop" }, "store_online": { "type": "boolean", "description": "Whether the shop is online", "example": true }, "auto_offline": { "type": "boolean", "description": "Whether auto offline is enabled", "example": false }, "auto_offline_hour": { "type": "integer", "description": "Auto offline hour (0-23). Only returned when auto_offline is true.", "example": 2 }, "auto_offline_minute": { "type": "integer", "description": "Auto offline minute (0 or 30). Only returned when auto_offline is true.", "example": 30 } } } } } } }, "security": [ { "bearer": [] } ], "operationId": "getShopStatus" }, "put": { "summary": "Update shop status", "description": "Updates the current account's shop status and automatic-offline settings. Every request is a complete configuration, so all writable fields are required.\n\nBUFF applies the normal seller checks, including Steam binding, trade URL, seller restrictions, account freezes, payment collection, permissions, and low-price warnings.\n\n- **Limit:** 60 requests per minute", "tags": [ "Official · Account" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "store_status", "auto_offline" ], "properties": { "store_status": { "type": "string", "enum": [ "online", "offline" ], "description": "Target shop state.", "example": "online" }, "auto_offline": { "type": "integer", "enum": [ 0, 1 ], "description": "Whether to enable auto offline. Required. 1=enable, 0=disable.", "example": 1 }, "auto_offline_hour": { "type": "integer", "description": "Auto offline hour (0-23). Required when auto_offline=1; ignored when auto_offline=0.", "example": 2 }, "auto_offline_minute": { "type": "integer", "enum": [ 0, 30 ], "description": "Auto offline minute (0 or 30). Required when auto_offline=1; ignored when auto_offline=0.", "example": 30 } } } } } }, "responses": { "200": { "description": "Shop status updated successfully. Empty body.", "content": { "application/json": { "schema": { "type": "object", "example": {} } } } }, "422": { "description": "Online prerequisite check failed, e.g: Steam not bound, seller punished, admin frozen, payment collection not enabled, meta permission denied, low-price warning." } }, "security": [ { "bearer": [] } ], "operationId": "updateShopStatus" } }, "/api/index/popular_sell_order": { "get": { "summary": "List popular sell orders", "operationId": "listPopularSellOrders", "description": "Returns the listings used by the BUFF home page.", "responses": { "200": { "description": "BUFF returns HTTP 200; inspect the response `code` field for application-level success.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopularSellOrderResponse" } } } } }, "x-observed-in-charles": true, "x-observed-count": 2, "security": [], "tags": [ "Internal API · Prices" ] } }, "/api/market/goods/info": { "get": { "summary": "Get item details", "operationId": "getGoodsInfo", "description": "Returns metadata and market capabilities for one goods ID.", "responses": { "200": { "description": "BUFF returns HTTP 200; inspect the response `code` field for application-level success.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GoodsInfoResponse" } } } } }, "parameters": [ { "name": "game", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "csgo" ] }, "description": "BUFF game slug." }, { "name": "goods_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "example": 43012 }, "description": "BUFF goods ID." } ], "security": [], "tags": [ "Internal API · Prices" ] } }, "/api/market/goods/buy_order": { "get": { "summary": "List item buy orders", "operationId": "listInternalBuyOrders", "description": "Returns the buy-order book for one item.", "responses": { "200": { "description": "BUFF returns HTTP 200; inspect the response `code` field for application-level success.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuyOrderResponse" } } } } }, "parameters": [ { "name": "game", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "csgo" ] }, "description": "BUFF game slug." }, { "name": "goods_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "example": 43012 }, "description": "BUFF goods ID." }, { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 }, "description": "Page number." } ], "x-observed-in-charles": true, "x-observed-count": 3, "security": [], "tags": [ "Internal API · Prices" ] } }, "/api/market/goods/sell_order": { "get": { "summary": "List item sell orders", "operationId": "listInternalSellOrders", "description": "Returns listings and asset details for one item.", "responses": { "200": { "description": "BUFF returns HTTP 200; inspect the response `code` field for application-level success.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SellOrderResponse" } } } } }, "parameters": [ { "name": "game", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "csgo" ] }, "description": "BUFF game slug." }, { "name": "goods_id", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 1, "example": 43012 }, "description": "BUFF goods ID." }, { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 }, "description": "Page number." }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "example": "default" }, "description": "Internal API sort key." }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional internal API listing mode." }, { "name": "allow_tradable_cooldown", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ], "default": 1 }, "description": "Set to 1 to include trade-locked listings." } ], "x-observed-in-charles": true, "x-observed-count": 9, "security": [], "tags": [ "Internal API · Prices" ] } } }, "servers": [ { "url": "https://buff.163.com" } ], "security": [], "externalDocs": { "description": "Official BUFF163 API documentation", "url": "https://buff.163.com/developer/documentation" } }