API Reference / Trade offers
Get the trade hold for a partner
Return the hold Steam would place on a trade between the account and a partner before it is sent, read live from Steam over the account's web session and reused for up to five minutes. A partner who is not a friend of the account needs the trade token from their trade URL. A token Steam refuses is a failed precondition with reason TRADE_TOKEN_REJECTED.
/ steam. v1. Steam/ GetTradeHoldDurationsRequest body
application/jsonRequired
Request for the trade hold Steam would place on a trade between an account and a partner, before sending it.
accountNamestringSteam account that would send the offer.
partnerSteamIdstringThe partner's 64-bit SteamID.
tradeToken?stringThe token from the partner's trade URL. Steam requires it when the partner is not a friend of the account.
Response body
application/json
Success
bothEscrow?TradeHoldDurationThe hold when both sides give items.
Show attributes
duration?stringHow long the items would be held.
endsAt?stringWhen the hold would end if the trade were made now. Unset when there is no hold or Steam gave no date.
Format"date-time"
myEscrow?TradeHoldDurationThe hold when only the account gives items.
Show attributes
duration?stringHow long the items would be held.
endsAt?stringWhen the hold would end if the trade were made now. Unset when there is no hold or Steam gave no date.
Format"date-time"
observedAt?stringWhen Steam reported these holds. Answers are reused for up to five minutes.
Format"date-time"
theirEscrow?TradeHoldDurationThe hold when only the partner gives items.
Show attributes
duration?stringHow long the items would be held.
endsAt?stringWhen the hold would end if the trade were made now. Unset when there is no hold or Steam gave no date.
Format"date-time"
application/json
The request was malformed, such as a missing required field or an unparseable cursor. The request cannot be carried out in the current system state.
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.
application/json
The service is temporarily unavailable. Retry with backoff.
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/GetTradeHoldDurations" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"tradeToken": "aBcD1234"
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/GetTradeHoldDurations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"tradeToken": "aBcD1234"
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"tradeToken": "aBcD1234"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/GetTradeHoldDurations", 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/GetTradeHoldDurations",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountName": "trader_bot_01",
"partnerSteamId": "76561198044443322",
"tradeToken": "aBcD1234"
},
)
data = res.json(){
"myEscrow": {
"duration": "0s"
},
"theirEscrow": {
"duration": "0s"
},
"bothEscrow": {
"duration": "0s"
},
"observedAt": "2026-11-08T10:00:00Z"
}{
"code": "failed_precondition",
"message": "The request cannot be carried out in the current system state."
}{
"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."
}{
"code": "unavailable",
"message": "The service is temporarily unavailable. Retry with backoff."
}