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

# Delete All Buy Orders

> Remove all your buy orders at once

## Overview

Deletes all of your buy orders in a single operation.

<Warning>
  This action cannot be undone! All your buy orders will be permanently removed.
</Warning>

<Note>
  No funds are returned when deleting buy orders since funds are never reserved when creating them. Payment only happens when a seller fulfills your order.
</Note>

## Authentication

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

## Rate Limit

**1 request per minute**

## Response

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

<ResponseField name="deleted_count" type="integer">
  Number of buy orders that were deleted
</ResponseField>

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

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/buy_orders', {
    method: 'DELETE',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_SITE_API_KEY'
    }
  });

  const data = await response.json();
  console.log(`Deleted ${data.deleted_count} buy orders`);
  ```

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

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

  data = response.json()
  print(f"Deleted {data['deleted_count']} buy orders")
  ```
</RequestExample>

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

## What Gets Deleted

This endpoint deletes:

* ✅ Active buy orders
* ✅ Inactive buy orders
* ✅ Partially filled buy orders (unfilled portion)

This endpoint does NOT affect:

* ❌ Completed buy order trades
* ❌ Pending trades (use trade management endpoints)
* ❌ Your marketplace listings

## Safety Tips

Before calling this endpoint:

1. **Confirm intent** - Make sure you really want to delete all buy orders
2. **Export data** - Save your buy order data if you need it later
3. **Consider scope** - This affects all buy orders, not just a subset

<Note>
  The `deleted_count` in the response shows how many buy orders were removed. Use this to verify the operation completed as expected.
</Note>

## Use Cases

<AccordionGroup>
  <Accordion title="Bot Shutdown">
    Cleanly remove all buy orders when shutting down your trading bot
  </Accordion>

  <Accordion title="Strategy Change">
    Clear all existing orders before implementing a new trading strategy
  </Accordion>

  <Accordion title="Account Cleanup">
    Remove old or outdated buy orders in bulk
  </Accordion>

  <Accordion title="Emergency Stop">
    Quickly halt all buying activity across all items
  </Accordion>
</AccordionGroup>