Power-User API

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 not on by default. It is enabled per account by the TTMT team. Once enabled, you create and manage your own API keys from the dashboard under Developer → API Keys.

---

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 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
Request limits and 429 handling	Rate Limiting
Error envelope shape, status codes	Errors
Live event feed, Last-Event-ID, recycling	Streaming
Per-endpoint parameters and response shapes	Reference
API-specific changelog	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