Skip to main content
PATCH
/
api
/
dev
/
buy_order
curl -X PATCH "https://api.liquid.tf/api/dev/buy_order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SITE_API_KEY" \
  -d '{
    "items": [{
      "sku": "5021;6",
      "price": 17000,
      "quantity": 8,
      "active": 1,
      "user_note": "Updated price - looking for quick sale"
    }]
  }'

{
  "success": true
}

​
Overview

Edits one or more existing buy orders. You can update the price, quantity, and active status. Max 100 buy orders per request.

​
Authentication

​
X-API-Key
string
required
Your site API key

​
Rate Limit

5 requests per minute

​
Request Body

​
items
array
required
Array of buy orders to edit (max 100 items)

​
Response

​
success
boolean
Returns true if buy orders were successfully updated
curl -X PATCH "https://api.liquid.tf/api/dev/buy_order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SITE_API_KEY" \
  -d '{
    "items": [{
      "sku": "5021;6",
      "price": 17000,
      "quantity": 8,
      "active": 1,
      "user_note": "Updated price - looking for quick sale"
    }]
  }'

{
  "success": true
}

​
Balance Validation

When editing a buy order:
  • The system checks if you have sufficient balance for the new quantity
  • If partially filled, the system validates you can cover the remaining quantity
  • If insufficient balance, the request will fail
Increasing quantity requires additional balance. Ensure you have enough funds before updating.

​
Active Status

Buy order is visible to sellers and can be fulfilled. Funds remain reserved.
Buy order is hidden from sellers and cannot be fulfilled. Funds remain reserved but order is paused.
Use active: 0 to temporarily pause a buy order without deleting it. This is useful when adjusting prices or waiting for market conditions.

​
Common Use Cases

Price Adjustments

Compete with other buyers by updating your price

Quantity Changes

Increase or decrease how many items you want

Pause Orders

Set active: 0 to temporarily stop fulfillment

Resume Orders

Set active: 1 to reactivate a paused order

​
User Notes

You can update the user note when editing a buy order. User notes are visible to all sellers and can help provide additional context.
User notes are limited to 180 characters and will be automatically filtered for profanity.