> ## 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.

# Create Buy Orders

> Create one or more buy orders for items you want to purchase

## Overview

Creates buy orders for items you want to buy. Sellers can fulfill your buy orders by sending you the items. Max 100 buy orders per request.

## Authentication

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

## Rate Limit

**5 requests per minute**

## Request Body

<ParamField body="items" type="array" required>
  Array of items to create buy orders for (max 100 items)

  <Expandable title="Item Object">
    <ParamField body="sku" type="string" required>
      Item SKU (e.g., `"5021;6"` for Mann Co. Supply Crate Key)
    </ParamField>

    <ParamField body="price" type="integer" required>
      Price per unit you're willing to pay (in cents)
    </ParamField>

    <ParamField body="quantity" type="integer" required>
      Number of items you want to buy
    </ParamField>

    <ParamField body="user_note" type="string">
      Custom note to display on the buy order (max 180 characters). Visible to sellers.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="multiaccount_proxy" type="string">
  Steam ID of a linked account to associate with these buy orders. When set, the buy order's automation status will be determined by that linked account's user agent OR the main account's autoaccept feature (whichever is active).
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Returns `true` if buy orders were successfully created
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.liquid.tf/api/dev/create_buy_order" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_SITE_API_KEY" \
    -d '{
      "items": [{
        "sku": "5021;6",
        "price": 16500,
        "quantity": 10,
        "user_note": "Looking for keys with clean history"
      }]
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/create_buy_order', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_SITE_API_KEY'
    },
    body: JSON.stringify({
      items: [{
        sku: '5021;6',
        price: 16500,
        quantity: 10,
        user_note: 'Looking for keys with clean history'
      }]
    })
  });

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

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

  response = requests.post(
      'https://api.liquid.tf/api/dev/create_buy_order',
      headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
      json={
          'items': [{
              'sku': '5021;6',
              'price': 16500,
              'quantity': 10,
              'user_note': 'Looking for keys with clean history'
          }]
      }
  )

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

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

## How Buy Orders Work

<Steps>
  <Step title="Create buy order">
    You create a buy order with your desired price and quantity
  </Step>

  <Step title="Balance checked">
    Your balance is checked to determine maximum affordable quantity
  </Step>

  <Step title="Sellers fulfill">
    Sellers with matching items can fulfill your buy order
  </Step>

  <Step title="Payment on fulfillment">
    Funds are only deducted from your balance when a seller fulfills the order
  </Step>
</Steps>

## Balance Requirements

<Note>
  **No funds are reserved** when creating buy orders. Your balance is only checked to limit the quantity to what you can afford. Payment happens when a seller fulfills your order.
</Note>

If your balance is insufficient to cover the full quantity, the buy order quantity will be automatically reduced to what you can currently afford:

```
Maximum Quantity = floor(your_balance / price_per_item)
```

## Linked Accounts

Use `multiaccount_proxy` to:

* Manage buy orders across multiple Steam accounts
* Separate trading activity between accounts
* Have different automation statuses per account

## User Notes

<Note>
  User notes are visible to all sellers and can help provide additional context about your buy order (e.g., "Looking for clean history", "Willing to negotiate on price").
</Note>

User notes are limited to **180 characters** and will be automatically filtered for profanity.