Skip to content

API Reference / Trade offers

Find trade offers by part of their id

Returns at most 3 trade offers in the workspace whose record id contains the given hex fragment, ids ending in the fragment first, then newest first, each with the account name and Steam offer id its page needs.

POST/steam.v1.Steam/GetTradeOfferReferencesByIDFragment

Request body

application/jsonRequired

Request for the trade offers in the caller's workspace whose record id contains a hex fragment.

idFragment?string

4 to 32 hexadecimal characters, case-insensitive, dashes ignored. Anything else is rejected with invalid_argument.

Response body

application/json

Success

tradeOffers?array<TradeOfferReference>

Ids ending in the fragment first, then newest first.

Show attributes
accountName?string

The workspace account the offer belongs to, the other half of the route key.

id?string

The record's full 16-byte id, TradeOffer.id.

Format"byte" base64

itemCount?integer

Items on both sides, so a label can say how many more there are.

Format"int32"

marketHashName?string

The first item given, else the first item received, for the label. Empty for an offer with no items.

offerId?string

Steam's offer id, half of the trade page's route key.

curl -X POST "https://api.goldmine.to/steam.v1.Steam/GetTradeOfferReferencesByIDFragment" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idFragment": "example"
  }'
{
  "tradeOffers": [
    {
      "accountName": "flip_eu_02",
      "id": "AY86PB0ufwCKGyw9Tl9gcQ==",
      "itemCount": 3,
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "offerId": "6512301874"
    }
  ]
}