Wiki Navigation

API Reference
CRUD Operations

Trader Items API

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.

Available Endpoints

GET /api/instance/{instance_sid}/trader-item

List all trader items for an instance

GET /api/instance/{instance_sid}/trader-item/{item_sid}

Get a specific trader item

POST /api/instance/{instance_sid}/trader-item

Create a new trader item

PATCH /api/instance/{instance_sid}/trader-item/{item_sid}

Update a trader item

DELETE /api/instance/{instance_sid}/trader-item/{item_sid}

Delete a trader item

Request Body Parameters

classname_id required

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

Pro Tips

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.