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"
}]
}'
const response = await fetch('https://api.liquid.tf/api/dev/buy_order', {
method: 'PATCH',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_SITE_API_KEY'
},
body: JSON.stringify({
items: [{
sku: '5021;6',
price: 17000,
quantity: 8,
active: 1,
user_note: 'Updated price - looking for quick sale'
}]
})
});
const data = await response.json();
import requests
response = requests.patch(
'https://api.liquid.tf/api/dev/buy_order',
headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
json={
'items': [{
'sku': '5021;6',
'price': 17000,
'quantity': 8,
'active': 1,
'user_note': 'Updated price - looking for quick sale'
}]
}
)
data = response.json()
{
"success": true
}
Buy Order Management
Edit Buy Orders
Update price, quantity, or status of existing buy orders
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"
}]
}'
const response = await fetch('https://api.liquid.tf/api/dev/buy_order', {
method: 'PATCH',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_SITE_API_KEY'
},
body: JSON.stringify({
items: [{
sku: '5021;6',
price: 17000,
quantity: 8,
active: 1,
user_note: 'Updated price - looking for quick sale'
}]
})
});
const data = await response.json();
import requests
response = requests.patch(
'https://api.liquid.tf/api/dev/buy_order',
headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
json={
'items': [{
'sku': '5021;6',
'price': 17000,
'quantity': 8,
'active': 1,
'user_note': 'Updated price - looking for quick sale'
}]
}
)
data = response.json()
{
"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
string
required
Your site API key
Rate Limit
5 requests per minuteRequest Body
array
required
Array of buy orders to edit (max 100 items)
Response
boolean
Returns
true if buy orders were successfully updatedcurl -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"
}]
}'
const response = await fetch('https://api.liquid.tf/api/dev/buy_order', {
method: 'PATCH',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_SITE_API_KEY'
},
body: JSON.stringify({
items: [{
sku: '5021;6',
price: 17000,
quantity: 8,
active: 1,
user_note: 'Updated price - looking for quick sale'
}]
})
});
const data = await response.json();
import requests
response = requests.patch(
'https://api.liquid.tf/api/dev/buy_order',
headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
json={
'items': [{
'sku': '5021;6',
'price': 17000,
'quantity': 8,
'active': 1,
'user_note': 'Updated price - looking for quick sale'
}]
}
)
data = response.json()
{
"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
Active (1)
Active (1)
Buy order is visible to sellers and can be fulfilled. Funds remain reserved.
Inactive (0)
Inactive (0)
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 fulfillmentResume Orders
Set
active: 1 to reactivate a paused orderUser 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.
