---
url: /api.md
description: >-
  Read-only REST + SSE API for programmatic access to your TTMT signals, trades,
  live positions, and accounts. Built for bots and scripts.
---

# Power-User API

::: info Availability
This feature is enabled per account by the TTMT team and is rolling out gradually. If you don't see
it in your dashboard yet, contact support to request access.
:::

TTMT provides a read-only REST + SSE API at `https://app.telegramtometatrader.com/api/v1`. It gives you programmatic access to your own signals, trades, live positions, and accounts — the same data the dashboard shows, accessible from a script or bot.

**What it can do:**

* Read your signals, trades, positions, and accounts
* Stream live position updates, order fills, TP hits, and trade lifecycle events
* Filter by account, channel, symbol, date window, or status
* Paginate through history

**What it cannot do:**

* Place, modify, or close trades
* Move funds
* Access another user's data

The surface is strictly GET-only. Any non-GET method returns `405`.

***

## Access

API access is enabled per account by the TTMT team (see the availability note above). Once it's on, you create and manage your own API keys on the **Connectors** page, in the **Developer API** tab.

***

## Base URL and format

```
https://app.telegramtometatrader.com/api/v1
```

* All responses are JSON with `snake_case` keys and UTC ISO-8601 timestamps.
* All responses carry `Content-Type: application/json`, except errors (`application/problem+json`) and the stream (`text/event-stream`).
* Versioning is in the URL path. Additive changes ship without a version bump. Breaking changes → `/api/v2`.

***

## Where to start

If you haven't set up a key yet: [Quickstart](/api/quickstart) walks you from zero to your first response in five steps.

Once you have a key:

| What you need | Page |
|:---|:---|
| Auth header, key format, disable vs. revoke | [Authentication](/api/authentication) |
| Request limits and `429` handling | [Rate Limiting](/api/rate-limiting) |
| Error envelope shape, status codes | [Errors](/api/errors) |
| Live event feed, `Last-Event-ID`, recycling | [Streaming](/api/streaming) |
| Per-endpoint parameters and response shapes | [Reference](/api/reference/) |
| API-specific changelog | [Changelog](/api/changelog) |

***

## Quick endpoint map

| Endpoint | Purpose |
|:---|:---|
| `GET /accounts` | List your MetaAPI accounts |
| `GET /signals` | Signals (paginated) |
| `GET /signals/{id}` | Full signal including raw Telegram message |
| `GET /trades` | Trades (paginated) |
| `GET /trades/{id}` | Fat trade: signal + positions + orders embedded |
| `GET /trades/{id}/positions` | Positions for a trade |
| `GET /trades/{id}/orders` | Orders for a trade |
| `GET /positions` | Currently-open positions across accounts |
| `GET /stream` | SSE live feed |
