> ## Documentation Index
> Fetch the complete documentation index at: https://docs.innova-trading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference for all InnovaTrading API endpoints

## Base URL

All API requests should be made to:

```
https://api.innova-trading.com
```

## Authentication

Include your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Response Format

All responses are JSON with a consistent structure:

### Success Response

```json theme={null}
{
  "success": true,
  "data": { ... }
}
```

### Error Response

```json theme={null}
{
  "error": "error_code",
  "message": "Human-readable error message",
  "details": { ... }
}
```

## HTTP Status Codes

| Code  | Description                               |
| ----- | ----------------------------------------- |
| `200` | Success                                   |
| `201` | Created                                   |
| `400` | Bad Request - Invalid parameters          |
| `401` | Unauthorized - Invalid or missing API key |
| `403` | Forbidden - No access to resource         |
| `404` | Not Found                                 |
| `429` | Rate Limit Exceeded                       |
| `500` | Internal Server Error                     |
| `503` | Service Unavailable                       |

## Available Endpoints

### Market Data

<CardGroup cols={2}>
  <Card title="GET /api/external/bars" href="/api-reference/market-data/get-bars">
    Fetch OHLC candlestick data
  </Card>

  <Card title="GET /api/external/symbols" href="/api-reference/market-data/get-symbols">
    List available trading symbols
  </Card>
</CardGroup>

### External Indicators

<CardGroup cols={2}>
  <Card title="POST /api/external/indicators/{id}" href="/api-reference/indicators/submit-indicator">
    Submit indicator signals
  </Card>

  <Card title="GET /api/external/indicators/{id}" href="/api-reference/indicators/get-indicator">
    Retrieve indicator data
  </Card>

  <Card title="DELETE /api/external/indicators/{id}" href="/api-reference/indicators/delete-indicator">
    Delete an indicator
  </Card>

  <Card title="GET /api/external/indicators" href="/api-reference/indicators/list-indicators">
    List all your indicators
  </Card>
</CardGroup>

## Pagination

Endpoints that return lists support pagination:

| Parameter     | Type    | Description                            |
| ------------- | ------- | -------------------------------------- |
| `limit`       | integer | Maximum items to return (default: 100) |
| `before_time` | integer | Unix timestamp for pagination          |

## Rate Limits

| Endpoint         | Limit    |
| ---------------- | -------- |
| GET /bars        | 100/hour |
| POST /indicators | 100/hour |
| GET /indicators  | 200/hour |

<Note>
  Rate limits are per API key. Contact us for higher limits.
</Note>