API приймання SMS

Купуйте номери й читайте коди підтвердження через JSON API. Без перевірки документів, оплата криптовалютою.

REST · JSONOpenAPI 3.1 Специфікація OpenAPI →

Кожна операція тут — це ще й інструмент MCP. REST-ендпоїнти є перекладом тих самих інструментів, які віддає MCP-сервер, тому автономний агент і звичайна інтеграція поводяться однаково. Якщо ви скеровуєте до OTPDrop ШІ-агента, почніть із розділу для агентів.

Як влаштований API?

  1. Створіть акаунт і збережіть повернутий seed. Це єдиний доступ, скинути його не можна.
  2. Створіть поповнення, надішліть криптовалюту й дочекайтеся зарахування.
  3. Купіть номер для потрібного сервісу та країни — гроші списуються з балансу миттєво.
  4. Опитуйте SMS із кодом. Якщо код не прийшов до завершення замовлення, гроші повертаються автоматично.

Поповнюйте один раз, купуйте багато: одного поповнення вистачає на стільки номерів, на скільки вистачить балансу, тому підтвердження чекає лише перша покупка.

Авторизація

Передавайте seed акаунта як bearer-токен. Окремого ключа API немає, виклику входу теж — seed і є облікові дані.

Authorization: Bearer YOUR-SEED-PHRASE

Ендпоїнтам каталогу авторизація не потрібна взагалі, тому сервіси, країни та ціни можна дивитися ще до появи акаунта. Усе, що стосується грошей і замовлень, вимагає заголовка.

Seed відновити не можна. Ми зберігаємо лише його хеш. Втратите — акаунт і його баланс зникнуть, без скидання і без обхідного шляху через підтримку.

Базова адреса

Усі ендпоїнти вказані відносно:

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Створено — акаунт, поповнення або замовлення тепер існує
401Seed у заголовку 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.

Параметри

Ім’яТипОпис
limitintegerнеобов’язковий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.

Параметри

Ім’яТипОпис
servicestringобов’язковийService code, e.g. telegram
countrystringобов’язковий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_usdnumberобов’язковийHow much to add to the balance, in USD. Minimum 25, maximum 1000.
coinstringобов’язковий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.

Параметри

Ім’яТипОпис
idstringобов’язковий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.

Параметри

Ім’яТипОпис
servicestringобов’язковийService code, e.g. telegram
countrystringобов’язковий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.

Параметри

Ім’яТипОпис
idstringобов’язковий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.

Параметри

Ім’яТипОпис
idstringобов’язковий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, нічого не витративши?

Каталог, розрахунок ціни та створення акаунта безкоштовні, тому більшу частину інтеграції можна зібрати й перевірити до поповнення балансу. Грошей коштує лише покупка.