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

# Load Pending Buy Order Trades

> Retrieve all pending buy order fulfillment trades

## Overview

Returns all pending buy order fulfillment trades (`type: "buy_order"`) where you are either the buyer (who created the buy order) or the seller (who is fulfilling the order).

<Note>
  For marketplace listing trades, use [Load Pending Marketplace Trades](/api-reference/trades/load-pending) instead.
</Note>

## Authentication

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

## Rate Limit

**1 request per minute**

## Response

<ResponseField name="array" type="array">
  Array of pending buy order trade objects

  <Expandable title="Trade Object">
    <ResponseField name="user_id" type="string">
      Your Steam ID
    </ResponseField>

    <ResponseField name="trade_id" type="string">
      Steam trade offer ID
    </ResponseField>

    <ResponseField name="timestamp" type="integer">
      Unix timestamp when trade was created
    </ResponseField>

    <ResponseField name="status" type="string">
      Human-readable status:

      * `"Action required"` - You are the seller and need to send the trade
      * `"Waiting for buyer"` - You are the seller waiting for buyer to accept
      * `"Waiting for seller"` - You are the buyer waiting for seller to send items
      * `"confirmation_required"` - Trade requires mobile confirmation
    </ResponseField>

    <ResponseField name="total" type="integer">
      Total price of all items in the trade (in cents)
    </ResponseField>

    <ResponseField name="trade_type" type="string">
      Always `"buy_order"` for buy order fulfillment trades
    </ResponseField>

    <ResponseField name="raw_status" type="string">
      Raw trade status (e.g., `"SENT"`, `"CONFIRMATION_REQUIRED"`)
    </ResponseField>

    <ResponseField name="buyer_id" type="string">
      Steam ID of the buyer (who created the buy order)
    </ResponseField>

    <ResponseField name="supplier_id" type="string">
      Steam ID of the seller (who is fulfilling the order)
    </ResponseField>

    <ResponseField name="buyer_steam_creation_time" type="integer">
      Unix timestamp of buyer's Steam account creation
    </ResponseField>

    <ResponseField name="supplier_steam_creation_time" type="integer">
      Unix timestamp of supplier's Steam account creation
    </ResponseField>

    <ResponseField name="partner_steam_creation_time" type="integer">
      Unix timestamp of actual trade partner's Steam account creation
    </ResponseField>

    <ResponseField name="verification_code" type="string">
      Trade verification code (if applicable)
    </ResponseField>

    <ResponseField name="supplier_linked_account" type="object" nullable>
      Profile data of linked account if supplier is using a linked account

      <Expandable title="Linked Account Object">
        <ResponseField name="id64" type="string">
          Steam ID of the linked account
        </ResponseField>

        <ResponseField name="name" type="string">
          Display name of the linked account
        </ResponseField>

        <ResponseField name="image_url" type="string">
          Avatar URL of the linked account
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="items" type="array">
      Array of items in the trade

      <Expandable title="Item Object">
        <ResponseField name="name" type="string">
          Display name of the item
        </ResponseField>

        <ResponseField name="sku" type="string">
          Item SKU (e.g., `"5021;6"`)
        </ResponseField>

        <ResponseField name="quantity" type="integer">
          Number of this item in the trade
        </ResponseField>

        <ResponseField name="price" type="integer">
          Price per unit (in cents)
        </ResponseField>

        <ResponseField name="quality" type="string">
          Item quality (e.g., `"Unique"`, `"Strange"`, `"Unusual"`)
        </ResponseField>

        <ResponseField name="image_url" type="string">
          Steam class ID for item image
        </ResponseField>

        <ResponseField name="particle_url" type="string" nullable>
          Effect ID for unusual items (null if not unusual)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.liquid.tf/api/dev/load_pending_buy_orders" \
    -H "X-API-Key: YOUR_SITE_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/load_pending_buy_orders', {
    headers: {
      'X-API-Key': 'YOUR_SITE_API_KEY'
    }
  });

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

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

  response = requests.get(
      'https://api.liquid.tf/api/dev/load_pending_buy_orders',
      headers={'X-API-Key': 'YOUR_SITE_API_KEY'}
  )

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

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "user_id": "76561198000000000",
      "trade_id": "7234567891",
      "timestamp": 1704067200,
      "status": "Action required",
      "total": 33000,
      "items": [
        {
          "name": "Mann Co. Supply Crate Key",
          "sku": "5021;6",
          "quantity": 2,
          "price": 16500,
          "quality": "Unique",
          "image_url": "563268321",
          "particle_url": null
        }
      ],
      "trade_type": "buy_order",
      "raw_status": "SENT",
      "buyer_id": "76561198111111111",
      "supplier_id": "76561198000000000",
      "buyer_steam_creation_time": 1234567890,
      "supplier_steam_creation_time": 1234567890,
      "partner_steam_creation_time": 1234567890,
      "verification_code": "ABC123",
      "supplier_linked_account": {
        "id64": "76561198222222222",
        "name": "Alt Account",
        "image_url": "https://avatars.steamstatic.com/abc123_full.jpg"
      }
    }
  ]
  ```
</ResponseExample>

## Key Differences from Marketplace Trades

<AccordionGroup>
  <Accordion title="Trade Type">
    `trade_type` is `"buy_order"` instead of `"market"`
  </Accordion>

  <Accordion title="Linked Accounts">
    Includes `supplier_linked_account` field when seller uses a linked account
  </Accordion>

  <Accordion title="Status Values">
    Different status values to reflect buy order fulfillment workflow
  </Accordion>

  <Accordion title="Buyer/Seller Roles">
    Buyer creates the buy order, seller fulfills it (reversed from marketplace)
  </Accordion>
</AccordionGroup>