Market VPSBot API Documentation

Welcome to the official documentation for the Market VPSBot API. This API allows you to programmatically browse items, execute purchases, track trades, and manage your wallet on market.vpsbot.io.

Base URL

All API requests use the base URL:

https://market.vpsbot.io/api

Getting Started

Before using the API, you'll need to:

1. Get your API key for authentication
2. Understand the available endpoints and their parameters
3. Implement the API using the provided code examples

API Overview

Items API

Browse and purchase items on the marketplace:

• List all items for sale with optional game filtering
• Search items by market hash name or market ID
• Buy items directly by asset ID or by name
• Check item availability before purchasing
• View recently sold items

Trades API

Track your trade history:

• Filter trades by date range, custom IDs, or trade IDs
• Paginate through large result sets
• Monitor trade statuses and errors

Wallet API

Manage your project wallet:

• Check current available balance
• View frozen (held) balance

Deprecated API Backward Compatibility

For users migrating from the deprecated API, we provide a fully backward-compatible API layer:

• Items (Deprecated API) — Same request/response format as the deprecated API
• Trades (Deprecated API) — Trade history in deprecated API format
• Wallet (Deprecated API) — Balance in deprecated API format

Response Format

All native API responses follow this structure:

{
  "success": true,
  "data": { ... }
}

Error responses:

{
  "success": false,
  "error": "Error message description"
}

Rate Limits

Some endpoints are rate-limited per user. When rate-limited, responses include headers:

Header	Description
X-RateLimit-Limit	Maximum requests allowed per window
X-RateLimit-Remaining	Remaining requests in current window

Exceeding the rate limit returns HTTP 429 Too Many Requests.

Support

If you encounter any issues or have questions, contact our support team via Telegram.