WebSocket
Offers
Offer message format and field reference for the real-time marketplace stream.
Message format
When a new offer is detected on a subscribed marketplace, you receive a JSON message with type: offer. Each message contains data for a single item listing.
Message fields
| Field | Type | Description |
|---|---|---|
type | string | Always offer |
eventType | string | Added when a new offer is listed, Updated when an existing offer changes |
marketplace | string | Name of the marketplace where the offer was found |
game | string | Game the item belongs to |
timestamp | number | Unix timestamp in milliseconds when the message was sent |
data | object | The offer data object |
Offer data fields
| Field | Type | Description |
|---|---|---|
name | string | Full item name including condition |
purchaseLink | string | Direct link to purchase the item on the marketplace |
priceUSD | number | Price in USD (always present) |
priceEUR | number|null | Price in EUR, if available |
priceCNY | number|null | Price in CNY, if available |
priceRUB | number|null | Price in RUB, if available |
daysTradeLocked | number|null | Days until the item becomes tradeable, 0 if tradeable now |
foundAt | number | Unix timestamp when the offer was detected |
CS2 fields
These fields are only present for CS2 (App ID 730) offers.
| Field | Type | Description |
|---|---|---|
inspectLink | string|null | Steam inspect link for the item |
float | number|null | Wear value between 0.0 and 1.0 |
paintIndex | number|null | Skin pattern ID |
paintSeed | number|null | Pattern seed number |
stickers | array|null | Applied stickers on the item |
Sticker object
| Field | Type | Description |
|---|---|---|
name | string | Sticker name |
wear | number | Sticker wear value (0.0 = pristine) |
slot | number | Sticker slot position on the item |
Dota 2 fields
These fields are only present for Dota 2 (App ID 570) offers.
| Field | Type | Description |
|---|---|---|
rarity | string|null | Item rarity |
hero | string|null | Associated hero name |
Rust fields
These fields are only present for Rust (App ID 252490) offers.
| Field | Type | Description |
|---|---|---|
itemType | string|null | Item category |
Message example
Example of a CS2 offer message with sticker data.
message.json
{
"type": "offer",
"eventType": "Added",
"marketplace": "CSFloat",
"game": "CS2",
"timestamp": 1711152000000,
"data": {
"name": "AK-47 | Redline (Field-Tested)",
"purchaseLink": "https://csfloat.com/item/abc123",
"inspectLink": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview...",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"float": 0.2341,
"paintIndex": 282,
"paintSeed": 123,
"daysTradeLocked": 0,
"foundAt": 1711152000,
"stickers": [
{
"name": "Natus Vincere | Katowice 2015",
"wear": 0.0,
"slot": 0
}
]
}
}