Manage trader items and pricing for your server. Control what items traders buy and sell, set prices, and configure stock quantities for trader mods.
Authentication required: All endpoints require a valid Bearer token. See Authentication for details.
Retrieve a paginated list of trader items for a specific instance.
GET /api/instance/{instance_sid}/trader-item
instance_sid
The SID of the instance (URL parameter)
page
integer
Page number for pagination. Defaults to 1.
like
string
Filter trader items by classname using partial match.
{
"current_page": 1,
"data": [
{
"sid": "abc123",
"classname_id": 456,
"classname": "AKM",
"buy_price": 5000,
"sell_price": 2500,
"stock": -1,
"trader_id": 1,
"enabled": true
}
],
"per_page": 30,
"total": 150
}Retrieve details of a specific trader item.
GET /api/instance/{instance_sid}/trader-item/{item_sid}
instance_sid
required
The SID of the instance
item_sid
required
The SID of the trader item
Create a new trader item for an instance.
POST /api/instance/{instance_sid}/trader-item
classname_id
Associated classname ID
buy_price
integer
Price players pay to buy
sell_price
integer
Price players receive when selling
stock
integer
Available stock quantity (-1 = unlimited)
trader_id
integer
ID of the trader selling this item
enabled
boolean
Whether item is available for trade
PATCH /api/instance/{instance_sid}/trader-item/{item_sid}
Update an existing trader item. Include only fields to change.
DELETE /api/instance/{instance_sid}/trader-item/{item_sid}
Permanently delete a trader item from the instance.
Set sell_price lower than buy_price to prevent infinite money exploits. Use stock limits for rare items to create scarcity. Set stock to -1 for common items that should always be available.