> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquid.tf/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Trade URL

> Update your Steam trade offer URL

## Overview

Sets or updates your Steam trade offer URL, which is used to send you trade offers when someone purchases from your listings or fulfills your buy orders.

## Authentication

<ParamField header="X-API-Key" type="string" required>
  Your site API key
</ParamField>

## Rate Limit

**1 request per minute**

## Request Body

<ParamField body="trade_url" type="string" required>
  Your Steam trade offer URL in the format:
  `https://steamcommunity.com/tradeoffer/new/?partner=XXXXXXX&token=XXXXXXXX`
</ParamField>

<ParamField body="multiaccount_proxy" type="string">
  Steam ID of a linked account to set the trade URL for. If provided, the trade URL will be set for that linked account instead of your main account.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Returns `true` if the trade URL was successfully updated
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.liquid.tf/api/dev/set_trade_url" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_SITE_API_KEY" \
    -d '{
      "trade_url": "https://steamcommunity.com/tradeoffer/new/?partner=123456&token=ABCDEF"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/set_trade_url', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_SITE_API_KEY'
    },
    body: JSON.stringify({
      trade_url: 'https://steamcommunity.com/tradeoffer/new/?partner=123456&token=ABCDEF'
    })
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.liquid.tf/api/dev/set_trade_url',
      headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
      json={
          'trade_url': 'https://steamcommunity.com/tradeoffer/new/?partner=123456&token=ABCDEF'
      }
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true
  }
  ```
</ResponseExample>

## How to Find Your Trade URL

Go to [your Steam trade offer settings](https://steamcommunity.com/id/me/tradeoffers/privacy#trade_offer_access_url) and copy your trade offer URL from the bottom of the page.

<Warning>
  Keep your trade URL private. Anyone with this URL can send you trade offers.
</Warning>

## Linked Accounts

Use `multiaccount_proxy` to:

* Set trade URLs for linked Steam accounts
* Manage multiple trading accounts from a single API key
* Keep trade URLs separate for different accounts