API for developers Telegram

Telegram API: sign in and choose channels

Telegram signal API: sign in to Telegram once, choose the channels TPcopier reads, each with its own rules, then link them to your trading accounts.

Sign in to Telegram once

TPcopier reads your channels with your own Telegram account, in our cloud: sign in once with the phone number and the code Telegram sends inside the Telegram app - and the two-step password, if the account has one.

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"phone":"+441234567890"}' https://tpcopier.com/api/v1/telegram/phone
curl -X POST -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/telegram/send-code
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"code":"12345"}' https://tpcopier.com/api/v1/telegram/verify-code
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"password":"TWO_STEP_PASSWORD"}' https://tpcopier.com/api/v1/telegram/verify-password

curl -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/telegram      # signed in, and as whom

Choose the channels to read

curl -X POST -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/channels/refresh   # load the chats you are in
curl -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/channels                   # each one's id (C)

# read this one - its own rules are fields of the same request (min_payout, allowed_directions, stake_override ...)
curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"monitored":true}' https://tpcopier.com/api/v1/channels/C

A channel that is read trades nothing until it is linked to an account: binary options or MetaTrader 4/5.

Further reading: Telegram's own API documentation.

Endpoints in this guide

Base address https://tpcopier.com. Send your key with every request - Authorization: Bearer tpc_... - up to 120 requests a minute. Open an endpoint for its fields, its answers and an example.

appStatus, signals, trades, accounts and settings
GET/api/v1/channelsChannels

One source's chats - Telegram's unless asked (WhatsApp and Discord have their own pages).

Parameters

sourcequerystring

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/channels"
PATCH/api/v1/channels/{cid}Patch Channel

Parameters

cid *pathinteger

Request body

{
  "monitored": false,
  "favorite": false,
  "color": "",
  "category": "",
  "min_confidence": "",
  "min_payout": 0,
  "max_signals_per_hour": 0,
  "stake_override": 0,
  "allowed_directions": "",
  "entry_mode": "",
  "tz_offset_min": 0,
  "default_duration": 0,
  "read_images": ""
}

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"monitored": false, "favorite": false, "color": "", "category": "", "min_confidence": "", "min_payout": 0, "max_signals_per_hour": 0, "stake_override": 0, "allowed_directions": "", "entry_mode": "", "tz_offset_min": 0, "default_duration": 0, "read_images": ""}' \
     "https://tpcopier.com/api/v1/channels/{cid}"
POST/api/v1/channels/bulkBulk Channels

Request body

{
  "action": "",
  "ids": [],
  "source": "tg"
}

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"action": "", "ids": [], "source": "tg"}' \
     "https://tpcopier.com/api/v1/channels/bulk"
liveTelegram sign-in and channels
GET/api/v1/telegramTelegram Status

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/telegram"
POST/api/v1/telegram/phoneTelegram Phone

The only thing a customer enters to connect: the platform holds the API keys.

Request body

{
  "phone": ""
}

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"phone": ""}' \
     "https://tpcopier.com/api/v1/telegram/phone"
POST/api/v1/telegram/send-codeTelegram Send Code

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/telegram/send-code"
POST/api/v1/telegram/verify-codeTelegram Verify Code

Request body

{
  "code": ""
}

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"code": ""}' \
     "https://tpcopier.com/api/v1/telegram/verify-code"
POST/api/v1/telegram/verify-passwordTelegram Verify Password

Request body

{
  "password": ""
}

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"password": ""}' \
     "https://tpcopier.com/api/v1/telegram/verify-password"
POST/api/v1/telegram/qr/startTelegram Qr Start

QR login (what Telegram Desktop uses) - for a number Telegram will not send a code to any more.

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/telegram/qr/start"
GET/api/v1/telegram/qr/statusTelegram Qr Status

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/telegram/qr/status"
POST/api/v1/telegram/logoutTelegram Logout

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/telegram/logout"
POST/api/v1/channels/refreshRefresh Channels

Responses

200 Successful Response · 422 Validation Error · 401 402 403 429 - see Errors

Example

curl -X POST -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/channels/refresh"