API Documentation

Welcome to the Aditis API documentation. The Aditis API allows you to programmatically interact with the platform to manage baskets, execute trades, and retrieve market data.

Base URL

All API requests should be made to:

https://api.aditis.com/v1

Note: The base URL will be finalized when the API is released.

Authentication

Most API endpoints require authentication. Authentication is handled via:

Session cookies (for web applications)
Bearer tokens (for programmatic access)

To obtain an API token, visit your Profile page after logging in.

API Endpoints

The following endpoints are planned for the Aditis API:

GET /api/baskets

Retrieve all baskets with current prices and statistics

GET /api/baskets/:id

Get detailed information about a specific basket

GET /api/baskets/:id/chart

Retrieve historical price data for a basket

GET /api/baskets/:id/underlyers

Get current prices and stats for basket underlyers

POST /api/trade

Execute a trade on a basket

GET /api/trades

Retrieve your trading history with PnL calculations

GET /api/markets/search

Search for markets on Polymarket and Kalshi

Response Format

All API responses will be in JSON format. Successful responses will have a status code of 200, while errors will return appropriate HTTP status codes (400, 401, 403, 404, 500, etc.).

Example Response

{
  "success": true,
  "data": {
    // Response data here
  }
}

Error Response

{
  "error": "Error message describing what went wrong",
  "code": "ERROR_CODE"
}

Rate Limiting

API rate limits will be implemented to ensure fair usage. Specific limits will be documented when the API is released.

SDKs and Libraries

Official SDKs for popular programming languages (Python, JavaScript, etc.) are planned for future release.

Getting Help

For questions about the API or to report issues:

Visit the Help Center for common questions
Contact us through our contact page

Changelog

API changes and updates will be documented here as they are released.

🚧 Work in Progress