API приймання SMS
Купуйте номери й читайте коди підтвердження через JSON API. Без перевірки документів, оплата криптовалютою.
Як влаштований API?
- Створіть акаунт і збережіть повернутий seed. Це єдиний доступ, скинути його не можна.
- Створіть поповнення, надішліть криптовалюту й дочекайтеся зарахування.
- Купіть номер для потрібного сервісу та країни — гроші списуються з балансу миттєво.
- Опитуйте SMS із кодом. Якщо код не прийшов до завершення замовлення, гроші повертаються автоматично.
Поповнюйте один раз, купуйте багато: одного поповнення вистачає на стільки номерів, на скільки вистачить балансу, тому підтвердження чекає лише перша покупка.
Авторизація
Передавайте seed акаунта як bearer-токен. Окремого ключа API немає, виклику входу теж — seed і є облікові дані.
Authorization: Bearer YOUR-SEED-PHRASE
Ендпоїнтам каталогу авторизація не потрібна взагалі, тому сервіси, країни та ціни можна дивитися ще до появи акаунта. Усе, що стосується грошей і замовлень, вимагає заголовка.
Базова адреса
Усі ендпоїнти вказані відносно:
https://otpdrop.com/api/v1
Відповіді — JSON. Тіла POST приймаються як application/json або
application/x-www-form-urlencoded.
Помилки
У разі збою повертається статус поза 2xx і один об’єкт помилки.
{
"error": {
"code": "invalid_request",
"message": "unknown service: \"whatsap\""
}
}
| Статус | Значення |
|---|---|
200 | Успіх |
201 | Створено — акаунт, поповнення або замовлення тепер існує |
401 | Seed у заголовку Authorization відсутній або хибний |
422 | Запит зрозуміло, але виконати його не можна |
500 | Збій на нашому боці |
Часті повідомлення при 422:
| Повідомлення | Причина |
|---|---|
insufficient_funds | Баланс менший за ціну — спершу створіть поповнення |
unknown service | Немає такого коду сервісу; див. список сервісів |
unknown country | Немає такого коду країни; див. список країн |
unknown coin | Монета не приймається; див. ендпоїнт поповнення |
amount_usd must be between… | Поповнення обмежене сумою $25–$1000 |
Чи є обмеження частоти?
Опублікованої квоти немає, і ключа API, який можна було б придушити, теж, — але викликати ендпоїнти в циклі не безкоштовно. Два з них призначені для опитування й потребують особливої акуратності.
| Ендпоїнт | Розумний темп | Чому |
|---|---|---|
| Каталог і розрахунок ціни | Кешуйте в себе | Ціни змінюються рідко; забирати каталог на кожен запит ні до чого. |
/topups/{id} | Раз на 10–15 секунд | Підтвердження в мережі займає хвилини, а не мілісекунди. Опитування частіше нічого не повідомить раніше. |
/orders/{id}/sms | Раз на 3–5 секунд | Коди зазвичай приходять за секунди; щільніший цикл лише додає навантаження. |
| Покупка | За потреби | Кожна покупка списує справжні гроші, тому цикл без гальм обійдеться вам дорожче, ніж нам. |
Трафік, схожий на атаку, буде заблоковано на підступах без ввічливого 429. Якщо у вас
є законна причина опитувати частіше, спершу напишіть на сторінку
контактів.
Список сервісів
GET/api/v1/services
Усі сервіси з кодом, категорією та мінімальною ціною. Авторизація не потрібна.
Запит
curl -s https://otpdrop.com/api/v1/services
Відповідь
{
"services": [
{
"code": "binance",
"name": "Binance",
"category": "Finance",
"from_price_cents": 85,
"color": "#F0B90B",
"icon": "binance"
}
],
"count": 133
}
Список країн
GET/api/v1/countries
Every country with its dial code and how many services are available there. No authentication required.
Запит
curl -s https://otpdrop.com/api/v1/countries
Відповідь
{
"countries": [
{
"code": "us",
"name": "United States",
"dial_code": "+1",
"service_count": 133
}
],
"count": 197
}
Матриця цін
GET/api/v1/catalog
The most useful service and country combinations with their prices, cheapest first. No authentication required.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
limit | integer | необов’язковий | How many rows to return, 1 to 500. Defaults to 12. |
Запит
curl -s 'https://otpdrop.com/api/v1/catalog?limit=2'
Відповідь
{
"items": [
{
"service": "badoo",
"country": "us",
"price_cents": 35
}
],
"count": 2
}
Розрахунок ціни
GET/api/v1/quote
The exact price for one service and country before you commit to buying. No authentication required.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
service | string | обов’язковий | Service code, e.g. telegram |
country | string | обов’язковий | Country code, e.g. us |
Запит
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'
Відповідь
{
"service": "telegram",
"country": "us",
"price_cents": 111,
"price_usd": "1.11",
"currency": "USD",
"purchasable": true
}
Створити акаунт
POST/api/v1/accounts
Generates an account and returns its seed. This is the only time the seed is ever shown. No authentication required.
Запит
curl -s -X POST https://otpdrop.com/api/v1/accounts
Відповідь
{
"public_id": "acc_7f3c1a92",
"seed": "PABh-ZbRt-9xKm-Lq4V",
"seed_prefix": "PABh",
"balance_cents": 0,
"warning": "This seed is shown exactly once, right now..."
}
Створити поповнення
POST/api/v1/topups
Claims a deposit address and returns the exact amount to send, as coin_amount, at the rate in rate_usd. Each top-up gets its own address, and it expires at expires_at. Send only the named coin, on the named network, before then.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
amount_usd | number | обов’язковий | How much to add to the balance, in USD. Minimum 25, maximum 1000. |
coin | string | обов’язковий | BTC, LTC, ETH, XMR, SOL, TRX, BNB, USDT, USDC and more |
Запит
curl -s -X POST https://otpdrop.com/api/v1/topups \
-H 'Authorization: Bearer YOUR-SEED' \
-H 'content-type: application/json' \
-d '{"amount_usd": 25, "coin": "XMR"}'
Відповідь
{
"topup_id": "top_019195919c80fc8f",
"status": "awaiting_payment",
"coin": "XMR",
"address": "89Rm4XN39m9PCr8Sr3yAFnXvLRRWQVEE...",
"amount_cents": 2500,
"amount_usd": "25.00",
"coin_amount": "0.1337",
"rate_usd": 187.02,
"bonus_cents": 0,
"credited_total_cents": 2500,
"expires_at": 1788532810
}
Статус поповнення
GET/api/v1/topups/{id}
Whether a deposit has been credited. Confirmation is not instant — poll this rather than assuming the funds arrived.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
id | string | обов’язковий | The top-up id, in the path |
Запит
curl -s https://otpdrop.com/api/v1/topups/top_019195919c80fc8f \ -H 'Authorization: Bearer YOUR-SEED'
Відповідь
{
"topup_id": "top_019195919c80fc8f",
"status": "credited",
"coin": "XMR",
"amount_usd": "25.00",
"coin_amount": "0.1337",
"credited_total_cents": 2500,
"expires_at": 1788532810
}
Купити номер
POST/api/v1/orders
Debits the balance and issues a number immediately. There is no per-purchase address and no second wait. Fails with insufficient_funds if the balance is short.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
service | string | обов’язковий | Service code, e.g. telegram |
country | string | обов’язковий | Country code, e.g. us |
Запит
curl -s -X POST https://otpdrop.com/api/v1/orders \
-H 'Authorization: Bearer YOUR-SEED' \
-H 'content-type: application/json' \
-d '{"service": "telegram", "country": "us"}'
Відповідь
{
"order_id": "ord_1ad450bf7a42519c",
"service": "telegram",
"country": "us",
"phone": "+15558329008",
"status": "paid",
"price_usd": "1.11"
}
Список ваших замовлень
GET/api/v1/orders
Every order on the account, newest first, with status, number and price. Useful for reconciling state after a restart rather than for polling.
Запит
curl -s https://otpdrop.com/api/v1/orders \ -H 'Authorization: Bearer YOUR-SEED'
Відповідь
{
"orders": [
{
"order_id": "ord_1ad450bf7a42519c",
"service": "telegram",
"country": "us",
"phone": "+15558329008",
"status": "paid",
"price_usd": "1.11"
}
],
"count": 1
}
Отримати замовлення
GET/api/v1/orders/{id}
The current state of one order: its number, status and price.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
id | string | обов’язковий | The order id, in the path |
Запит
curl -s https://otpdrop.com/api/v1/orders/ord_1ad450bf7a42519c \ -H 'Authorization: Bearer YOUR-SEED'
Відповідь
{
"order_id": "ord_1ad450bf7a42519c",
"service": "telegram",
"country": "us",
"phone": "+15558329008",
"status": "paid",
"price_usd": "1.11"
}
Отримати SMS із кодом
GET/api/v1/orders/{id}/sms
Poll this until arrived turns true. If the order expires with nothing delivered, the price returns to your balance automatically.
Параметри
| Ім’я | Тип | Опис | |
|---|---|---|---|
id | string | обов’язковий | The order id, in the path |
Запит
curl -s https://otpdrop.com/api/v1/orders/ord_1ad450bf7a42519c/sms \ -H 'Authorization: Bearer YOUR-SEED'
Відповідь
{
"order_id": "ord_1ad450bf7a42519c",
"status": "paid",
"arrived": false,
"code": null
}
Який вигляд має готова інтеграція?
Від акаунта до коду — шість викликів. Усе нижче справжнє: вставте й запустіть.
# 1. Створюємо акаунт і зберігаємо seed
SEED=$(curl -s -X POST https://otpdrop.com/api/v1/accounts | jq -r .seed)
# 2. Поповнюємо — надішліть coin_amount на повернуту адресу
curl -s -X POST https://otpdrop.com/api/v1/topups \
-H "Authorization: Bearer \$SEED" \
-H 'content-type: application/json' \
-d '{"amount_usd": 25, "coin": "USDT"}'
# 3. Опитуємо, доки поповнення не зарахується
curl -s https://otpdrop.com/api/v1/topups/TOPUP_ID \
-H "Authorization: Bearer \$SEED" | jq .status
# 4. Перевіряємо ціну, перш ніж купувати
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'
# 5. Купуємо — гроші списуються, номер видається одразу
ORDER=$(curl -s -X POST https://otpdrop.com/api/v1/orders \
-H "Authorization: Bearer \$SEED" \
-H 'content-type: application/json' \
-d '{"service": "telegram", "country": "us"}' | jq -r .order_id)
# 6. Опитуємо код
until curl -s https://otpdrop.com/api/v1/orders/\$ORDER/sms \
-H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done
Та сама послідовність на Python, без шела:
import time, requests
API = "https://otpdrop.com/api/v1"
seed = requests.post(f"{API}/accounts").json()["seed"]
auth = {"Authorization": f"Bearer {seed}"}
topup = requests.post(f"{API}/topups", headers=auth,
json={"amount_usd": 25, "coin": "USDT"}).json()
print("send", topup["coin_amount"], topup["coin"], "to", topup["address"])
while requests.get(f"{API}/topups/{topup['topup_id']}",
headers=auth).json()["status"] != "credited":
time.sleep(15)
order = requests.post(f"{API}/orders", headers=auth,
json={"service": "telegram", "country": "us"}).json()
print("number:", order["phone"])
while True:
sms = requests.get(f"{API}/orders/{order['order_id']}/sms",
headers=auth).json()
if sms["arrived"]:
print("code:", sms["code"])
break
time.sleep(4)
MCP-сервер
Ті самі операції доступні через Model Context Protocol на https://otpdrop.com/mcp — одинадцятьма
інструментами. Додати в Claude Code:
claude mcp add --transport http otpdrop https://otpdrop.com/mcp
Налаштування та повний список інструментів — на сторінці для агентів.
Файли виявлення
Машиночитні описи сервісу, усі віддаються без авторизації.
| Файл | Вміст |
|---|---|
/openapi.json | Повна схема OpenAPI 3.1 |
/.well-known/agent.json | Можливості, модель авторизації та правила роботи |
/llms.txt | Стислий орієнтир для мовних моделей |
/llms-full.txt | Те саме з повним каталогом усередині |
Часті запитання
Чи потрібен для API OTPDrop ключ?
Ні. Нічого не треба запитувати, погодження немає. Обліковими даними слугує seed акаунта, переданий як bearer-токен, а ендпоїнтам каталогу не потрібні й вони.
Скільки коштує API OTPDrop?
Нічого понад самі номери. Ні підписки, ні плати за виклик, ні мінімального обсягу — ціни ті самі, що й на сайті.
З якими мовами програмування працює API?
З будь-якою, що вміє робити HTTPS-запит. Це звичайний JSON поверх HTTP з bearer-заголовком: SDK ставити не потрібно і синхронізуватися з нашими релізами теж.
Що буде, якщо SMS із кодом не прийде?
Замовлення поверне гроші на баланс саме, коли строк мине; скасувати раніше можна через сайт. Ви платите за доставлені коди, а не за спроби.
REST API та MCP-сервер — це те саме?
Так, навмисно. Кожен REST-ендпоїнт — переклад одного виклику інструмента MCP, тому розійтися вони не можуть: правка одного є правкою обох. Обирайте те, що зручніше вашому клієнту.
Чи можна протестувати API, нічого не витративши?
Каталог, розрахунок ціни та створення акаунта безкоштовні, тому більшу частину інтеграції можна зібрати й перевірити до поповнення балансу. Грошей коштує лише покупка.