---
url: /api/reference.md
description: >-
  Full endpoint reference for the TTMT Power-User Read-Only API — all nine GET
  endpoints.
---

# API Reference

Nine read-only endpoints at `https://app.telegramtometatrader.com/api/v1`.

All requests require `Authorization: Bearer ttmt_live_…`. See [Authentication](/api/authentication) and [Errors](/api/errors).

***

## Endpoints

| Endpoint | Description |
|:---|:---|
| [GET /accounts](/api/reference/list-accounts) | List your connected MetaAPI accounts |
| [GET /signals](/api/reference/list-signals) | List signals with filters and cursor pagination |
| [GET /signals/{id}](/api/reference/get-signal) | Full signal including raw Telegram message text |
| [GET /trades](/api/reference/list-trades) | List trades with filters and cursor pagination |
| [GET /trades/{id}](/api/reference/get-trade) | Fat trade: signal + positions + orders embedded |
| [GET /trades/{id}/positions](/api/reference/get-trade-positions) | Positions for a specific trade |
| [GET /trades/{id}/orders](/api/reference/get-trade-orders) | Orders for a specific trade |
| [GET /positions](/api/reference/list-positions) | Currently-open positions across your accounts |
| [GET /stream](/api/reference/get-stream) | SSE live event feed |

***

## Pagination

List endpoints (`/signals`, `/trades`) use cursor-only keyset pagination, newest first.

```json
{
  "data": [ /* items */ ],
  "has_more": true,
  "next_cursor": "MjAyNi0wNi0wOFQwOToxNDoyMlp8N2Y4ZQ"
}
```

Pass `?after=<next_cursor>` for the next page. Pass `?limit=` (1–100, default 50). The cursor is opaque — never build it yourself.

`after_date` / `before_date` are a date window for filtering — a different concept from the `after` pagination cursor.

***

## Filters quick reference

| Parameter | Endpoints | Notes |
|:---|:---|:---|
| `status` | signals, trades | validated enum; unknown → `400` |
| `symbol` | trades | exact match |
| `channel_id` | signals, trades | UUID |
| `account_id` | signals, trades, positions, stream | DB UUID from `GET /accounts` |
| `after_date` / `before_date` | signals, trades | ISO-8601 |
| `limit` / `after` | signals, trades | pagination |
| `include` | trades | `signal,positions,orders` |

***

## Money and shapes

All financial objects carry `currency`, `account_id`, and `account_label`. Amounts are in the account's currency. Null TP/SL are JSON `null`, never `0`.

Terminal `GET /trades/{id}` and `GET /signals/{id}` return a strong `ETag` and answer `If-None-Match` with `304`. Active records return `no-cache`.

***
