---
title: "🔎 Retrieve Trade History"
method: POST
path: "/steam/api/trade/history"
tags: ["Tradeoffer"]
---

# 🔎 Retrieve Trade History

`POST /steam/api/trade/history`

## Request

- Base URL: `https://www.steamwebapi.com`
- URL: `https://www.steamwebapi.com/steam/api/trade/history`
- Auth: API key in query parameter `key`

Baseurl: https://www.steamwebapi.com/steam/api/trade/history?key=YOUR_API_KEY

    💬 **Retrieve the trade history of a user.**
    - This endpoint uses the official Steam Web API (IEconService/GetTradeHistory) for accurate and reliable trade data.
    - Perfect for verifying trade success and tracking the user's trade activity.
    - **Rate Limiting:** You may experience delays if too many requests are made in a short period, as each `steamloginsecure` token is rate-limited.
    - **Real-time Data:** The `steamloginsecure` token ensures real-time data retrieval from Steam. You can use the Extension for automatic token retrieval.
    - **Trade Protection System:** With Steam's Trade Protection System, trades can be reversed within 7 days. The `tradeprotected` and `tradeprotecteduntil` fields indicate if a trade is still in the protection period. The exact settlement date comes directly from Steam.
    - **New Fields:** Each trade now includes a `tradeid` field and `tradeprotecteduntiltimestamp`. Received items include `originalassetid` and `newassetid`. Sent items include `newassetid`. Items may include `ownerdescriptions` when available from Steam.

    🛠️ **Important Parameters:**
    - **steamloginsecure**: Required. The raw steamLoginSecure token from the `steamcommunity.com` cookie for authentication.
    - **after_time**: Optional. Pagination cursor — pass the value from `nexthistoryaftertimestamp` of the previous response.
    - **after_trade**: Optional. Pagination cursor — pass the value from `nexthistoryaftertrade` together with `after_time`.
    - **assetid**: Optional. Filter trades by a specific asset ID to track a particular item.

    🌐 **How to Use:**
    - Send the `steamloginsecure` cookie value (or use our Extension for automatic retrieval) to fetch trade history data for the user.
    - Use the `after_time` and `after_trade` parameters together for precise pagination (both values come from `nexthistoryaftertimestamp` and `nexthistoryaftertrade` of the previous response).
    - Use the `assetid` parameter to track specific items and check if they were involved in reversed trades. Searches across `assetid`, `originalassetid`, and `newassetid`.
    - Check the `status` field in the response to determine if a trade is "traded" or "reversed".
    - The `tradereturned` property provides details about reversed trades, allowing services to unfreeze funds after the 7-day trade hold period.
    - **Note:** `participantusername` contains the trade partner's SteamID64 (username is not available from the Steam API). Use `participantsteamid` for the same value.

## Request body

- object
  - `steamloginsecure` string, required: Raw steamLoginSecure from the cookie of steamcommunity.com or use our Extension for automatic retrieval.

## Response `200`

Success - Trade history successfully retrieved.

- object
  - `datetime` string: Current datetime in ISO 8601 format
  - `type` string: Type of the response
  - `steamid` string: Steam ID of the user
  - `verified` boolean: Whether the trade history is verified
  - `nexthistoryaftertimestamp` string, nullable: Unix timestamp to pass as `after_time` query parameter to retrieve the next page of trades.
  - `nexthistoryaftertrade` string, nullable: Trade ID to pass as `after_trade` query parameter — use together with `nexthistoryaftertimestamp` for precise pagination.
  - `data` object[]: Array of trade history entries
    - `tradeid` string: Unique trade ID from Steam
    - `date` string: Trade date in ISO 8601 format (UTC)
    - `timestamp` integer: Trade Unix timestamp
    - `participantusername` string: SteamID64 of the trade partner (username not available from Steam API)
    - `participanturl` string: Steam profile URL of the trade partner
    - `participantsteamid` string: SteamID64 of the trade partner
    - `status` string: Status of the trade: "traded" or "reversed"
    - `tradeprotected` boolean: Whether the trade is still in the 7-day protection period
    - `tradeprotecteduntil` string, nullable: Date until which the trade is protected (Y-m-d format)
    - `tradeprotecteduntiltimestamp` integer, nullable: Unix timestamp until which the trade is protected (from Steam time_settlement)
    - `tradeinfo` string: Human-readable trade info text (e.g. You traded with "76561198769457065".)
    - `tradereturned` object, nullable: Information about trade reversal (null if not reversed)
      - `tradeReversed` boolean: Whether the trade was reversed
      - `reversalAt` string, nullable: UTC datetime when the trade was reversed (Y-m-d H:i:s)
      - `reversalReason` string, nullable: Reason for the trade reversal
      - `status` string: Status of the reversal
    - `items` object: Items involved in the trade
      - `received` object[]: Items received. Each item includes assetid (=newassetid for backward compat), originalassetid, and newassetid.
      - `sent` object[]: Items sent. Each item includes assetid and newassetid.

## Other responses

- `400`: Bad request or missing parameters.
- `401`: Unauthorized access due to missing or invalid steamloginsecure token.
- `402`: Rate limit exceeded (daily or monthly).
- `405`: Invalid steamloginsecure provided. Please verify your steamloginsecure and try again.
- `406`: Your steamloginsecure is expired. Please verify your steamloginsecure and try again.
- `408`: Invalid steamloginsecure provided. Please verify your steamloginsecure and try again.
- `421`: Missing required parameters or rate limit exceeded
- `422`: Invalid JSON format in the request.
- `429`: Rate limit exceeded for requests.
- `430`: You must wait before making another request using this steamloginsecure to avoid being banned from steamcommunity.com.

---

[API](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation.md) · [All operations](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/revisions/f9a4109cbda6?raw)