API Reference / Steam chat
Get an account's owned Steam emoticons
Read the last known actual chat emoticon entitlements observed by the account's normal Steam session. Observation timestamps distinguish a successful empty list from an unobserved or stale snapshot. This read does not contact Steam or force a refresh.
/ steam. v1. Steam/ GetEmoticonListRequest body
application/jsonRequired
Request for the chat emoticons an account owns, as last observed by its Steam session. Does not contact Steam.
accountNamestringSteam account whose chat emoticon snapshot to read.
Response body
application/json
Success
emoticonList?EmoticonListThe account's last known entitlement snapshot, including observation and refresh state.
Show attributes
accountName?stringAccount whose entitlements were observed.
emoticons?array<Emoticon>Actual returned entitlements. Empty with observed_at is an observed empty list. Empty without it is unknown.
Show attributes
appId?integerApp that supplies the emoticon when reported by Steam.
Format"int32"
count?integerSteam reported owned count. A zero count can still identify an entitled default emoticon.
Format"int32"
iconUrl?stringValve hosted emoticon icon for a supported token. Absent when no safe supported image token is available.
lastUsedAt?stringLast use reported by Steam, absent when never used.
Format"date-time"
name?stringThe exact Steam token, normally including outer colons. This name is authoritative for chat composition.
receivedAt?stringReceipt time reported by Steam, absent for an unreported or default entitlement.
Format"date-time"
useCount?integerUsage count reported by Steam.
Format"int32"
lastAttemptAt?stringLast normal session refresh attempt, whether successful or failed.
Format"date-time"
lastRefreshFailed?booleanThe most recent normal refresh failed. Any prior observed entitlements and their timestamp remain available as cached data.
observedAt?stringLast successful Steam observation. Absent when no successful snapshot has been observed.
Format"date-time"
workspaceId?stringWorkspace that owns the account.
Format"byte" base64
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The requested resource does not exist in this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
curl -X POST "https://api.goldmine.to/steam.v1.Steam/GetEmoticonList" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountName": "flip_eu_02"
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/GetEmoticonList", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "flip_eu_02"
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "flip_eu_02"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/GetEmoticonList", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/steam.v1.Steam/GetEmoticonList",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "flip_eu_02"
},
)
data = res.json(){
"emoticonList": {
"accountName": "flip_eu_02",
"emoticons": [
{
"appId": 730,
"count": 3,
"iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/redline-ft",
"lastUsedAt": "2026-11-03T16:10:00Z",
"name": "Rifle accounts",
"receivedAt": "2026-11-03T16:10:00Z",
"useCount": 3
}
],
"lastAttemptAt": "2026-11-03T16:10:00Z",
"lastRefreshFailed": false,
"observedAt": "2026-11-03T16:10:00Z",
"workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ=="
}
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "not_found",
"message": "The requested resource does not exist in this workspace."
}{
"code": "internal",
"message": "An internal server error occurred."
}