Get User Trade Inventory

There are several ways to get a user’s inventory (including your own).

  • By app_id using the GetInventory endpoint. This endpoint requires a bearer token to get a user’s inventory, or your API key to get your inventory.

    Get Your Inventory

    
    curl -X GET \
      'https://api-trade.wax-sandbox.com/IUser/GetInventory/v2?app_id=1' \
      -H "X-API-Key: 999d9ab99cde999a99cb9999df9999" \
      -H 'cache-control: no-cache' 
    

    Get a User’s Inventory

    
    curl -X GET \
     'https://api-trade.wax-sandbox.com/IUser/GetInventory/v2?app_id=1' \
      -H 'Authorization: Bearer 452589dfgghhjjkl4885521236985' \
      -H 'cache-control: no-cache' 
    
  • By uid and app_id using the GetUserInventory endpoint. This endpoint does not require a bearer token, but you will need to parse the uid from a user’s trade URL.

    
    curl -X GET \
      'https://api-trade.wax-sandbox.com/ITrade/GetUserInventory/v1/?app_id=1&uid=6434081' \
      -H "X-API-Key: 999d9ab99cde999a99cb9999df9999" \
      -H 'cache-control: no-cache' 
    
  • By steam_id and app_id using the GetUserInventoryFromSteamId endpoint.

Before you can use these endpoints, you’ll need to get a list of categories (apps). Refer to Get Apps for more information. Once you have a list of app_ids, you can:

  • Get inventory items by a single category (e.g., VGO)
  • Get inventory items from a list of categories (e.g., VGO, Digital Games)
  • Get all inventory items from all categories

All of these endpoints return a paginated JSON response, including the item id (e.g., “id”: 984414) and other item details.

{
    "status": 1,
    "time": 1567875265,
    "current_page": 1,
    "total_pages": 1,
    "response": {
        "items": [
            {
                "id": 1313589,
                "internal_app_id": 1,
                "name": "Butterfly Knife | Dreamer II (Well-Worn)",
                "color": "#eb4b4b",
                "image": "https://files.opskins.media/file/vgo-img/item/butterfly-knife-dreamer-ii-well-worn-300.png",
                "suggested_price": 34783,
                "suggested_price_floor": 34783,
                "tradable": true,
                "is_trade_restricted": false,
                "time_created": 1558481483,
                "time_updated": 1567637951,
                "attributes": {
                    "assets_3d_model": "https://files.opskins.media/file/vgo-img/assets/3d-models/butterfly_knife.obj",
                    "assets_main_texture_processed": null,
                    "assets_raw_textures": "https://files.opskins.media/file/vgo-img/assets/raw-textures/butterfly_knife_dreamer_ii.zip",
                    "assets_type": "csgo_compatible_files",
                    "category": "Covert Knife",
                    "def_id": 5268,
                    "eth_inspect": null,
                    "image_generic_300": "https://files.opskins.media/file/vgo-img/item/butterfly-knife-dreamer-ii-well-worn-300.png",
                    "image_generic_600": "https://files.opskins.media/file/vgo-img/item/butterfly-knife-dreamer-ii-well-worn-600.png",
                    "inspect": null,
                    "internal_app_id": 1,
                    "paint_index": null,
                    "pattern_index": 592,
                    "preview_url_3d_viewer": null,
                    "preview_url_back_image": "https://files.opskins.media/file/vgo-img/previews/9149319_back.jpg",
                    "preview_url_front_image": "https://files.opskins.media/file/vgo-img/previews/9149319_front.jpg",
                    "preview_url_front_image_low": "https://files.opskins.media/file/vgo-img/previews/9123291_front.jpg",
                    "preview_url_thumb_image": "https://files.opskins.media/file/vgo-img/previews/9123291_thumb.jpg",
                    "preview_url_video": "https://files.opskins.media/file/vgo-img/previews/9149319_video.webm",
                    "rarity": "Covert",
                    "serial_sku": 128,
                    "serial_sku_wear": 9,
                    "sku": 10403,
                    "suggested_price_floor": 34783,
                    "trade_hold_expires": null,
                    "type": "Knife",
                    "wear": 0.38836389780044556,
                    "wear_tier_index": 4
                },
                "instant_sell_enabled": true
            },
            {
                "id": 984414,
                "internal_app_id": 1,
                "name": "Bayonet | Blood Treasure II (Battle-Scarred)",
                "color": "#eb4b4b",
                "image": "https://files.opskins.media/file/vgo-img/item/bayonet-blood-treasure-ii-battle-scarred-300.png",
                "suggested_price": 23141,
                "suggested_price_floor": 23141,
                "tradable": true,
                "is_trade_restricted": false,
                "time_created": 1556893807,
                "time_updated": 1567537593,
                "attributes": {
                    "assets_3d_model": "https://files.opskins.media/file/vgo-img/assets/3d-models/bayonet.obj",
                    "assets_main_texture_processed": null,
                    "assets_raw_textures": "https://files.opskins.media/file/vgo-img/assets/raw-textures/bayonet_blood_treasure_ii.zip",
                    "assets_type": "csgo_compatible_files",
                    "category": "Covert Knife",
                    "def_id": 5179,
                    "eth_inspect": null,
                    "image_generic_300": "https://files.opskins.media/file/vgo-img/item/bayonet-blood-treasure-ii-battle-scarred-300.png",
                    "image_generic_600": "https://files.opskins.media/file/vgo-img/item/bayonet-blood-treasure-ii-battle-scarred-600.png",
                    "inspect": null,
                    "internal_app_id": 1,
                    "paint_index": null,
                    "pattern_index": 81,
                    "preview_url_3d_viewer": null,
                    "preview_url_back_image": "https://files.opskins.media/file/vgo-img/previews/9065787_back.jpg",
                    "preview_url_front_image": "https://files.opskins.media/file/vgo-img/previews/9065787_front.jpg",
                    "preview_url_front_image_low": "https://files.opskins.media/file/vgo-img/previews/9043565_front.jpg",
                    "preview_url_thumb_image": "https://files.opskins.media/file/vgo-img/previews/9043565_thumb.jpg",
                    "preview_url_video": "https://files.opskins.media/file/vgo-img/previews/9065787_video.webm",
                    "rarity": "Covert",
                    "serial_sku": 127,
                    "serial_sku_wear": 75,
                    "sku": 10385,
                    "suggested_price_floor": 23141,
                    "trade_hold_expires": null,
                    "type": "Knife",
                    "wear": 0.9028963446617126,
                    "wear_tier_index": 5
                },
                "instant_sell_enabled": true
            }
        ],
        "total": "2",
        "items_in_active_offers": {
            "984414": [
                "24604"
            ],
            "1313589": [
                "24605"
            ]
        },
        "sort_parameters": [
            {
                "value": 1,
                "display_name": "Alphabetical A-Z"
            },
            {
                "value": 2,
                "display_name": "Alphabetical Z-A"
            },
            {
                "value": 3,
                "display_name": "Oldest first"
            },
            {
                "value": 4,
                "display_name": "Newest first"
            },
            {
                "value": 5,
                "display_name": "Price low to high"
            },
            {
                "value": 6,
                "display_name": "Price high to low"
            }
        ]
    }
}
Note: Users have the option to make their inventory private from the WAX ExpressTrade > Settings page.

What's Next