Skip to main content
GET
List sub-user trades

Authorizations

api-key
string
header
required

Your raw API key. Generate, rotate, and revoke keys from the merchant dashboard. Keys can optionally be bound to one or more allowed source IPs — requests from any other IP are rejected with API_KEY_IP_DENIED.

Path Parameters

id
string
required
Required string length: 1 - 128

Query Parameters

type
enum<string>

buy = purchased from a marketplace; sell = sold to a SkinShark bot for a payout.

Available options:
buy,
sell
status
enum<string>

Terminal outcomes — completed (delivered), failed (couldn't be placed/delivered; see item error), canceled (canceled before delivery — full refund, no penalty), declined (buyer-fault decline after the Steam offer was sent — refund minus a 2% penalty), reverted (delivered then recalled by the supplier).

Available options:
initiated,
pending,
active,
hold,
completed,
failed,
canceled,
declined,
reverted
hideResolved
boolean

Excludes failed + reverted (auto-refunded) trades. Ignored when status is set.

itemName
string
externalId
string
offerId
string
tradeId
string
from
string<date-time>
to
string<date-time>
cursor
string<uuid>
limit
integer
default:25
Required range: 1 <= x <= 100

Response

OK.

requestId
string
required
success
boolean
required
data
object

Merchant-scope trade list (/merchant/trades, /merchant/users/:id/trades).

error
object