WaveMarket API Documentation

Welcome to the WaveMarket API documentation. Our API provides programmatic access to WaveMarket's powerful trading platform, market data, and AI-powered insights. This guide will help you get started with integrating WaveMarket into your applications.

The WaveMarket API is organized around REST principles. It uses standard HTTP response codes, authentication, and verbs. All responses are returned in JSON format.

Base URL for all API requests:

https://api.wavemarket.com/v1

The WaveMarket API uses API keys to authenticate requests. You can view and manage your API keys in the API section of your WaveMarket dashboard.

Authentication is performed via HTTP headers:

X-API-Key: your_api_key
X-API-Secret: your_api_secret

Example request with authentication:

// Using fetch in JavaScript
fetch('https://api.wavemarket.com/v1/account', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key',
    'X-API-Secret': 'your_api_secret'
  }
})
.then(response => response.json())
.then(data => console.log(data));

The WaveMarket API implements rate limiting to protect our infrastructure and ensure fair usage. Rate limits vary based on the endpoint and your account tier.

Rate limit headers are included in all API responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1617192000

If you exceed the rate limit, you will receive a 429 Too Many Requests response. The response will include a Retry-After header indicating how many seconds to wait before making another request.

The WaveMarket API uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided, and codes in the 5xx range indicate an error with WaveMarket's servers.

All error responses include a JSON object with the following properties:

{
  "error": {
    "code": "invalid_request",
    "message": "The request was unacceptable, often due to missing a required parameter.",
    "status": 400
  }
}