SMS受信API
JSONのAPIで番号を購入し、認証コードを読み取れます。本人確認はなく、支払いは 暗号資産です。
APIはどのように構成されていますか?
- アカウントを作成し、返されたフレーズを保存します。それが唯一のアクセス手段で、再設定はできま せん。
- チャージを作成し、暗号資産を送金して、反映をお待ちください。
- 目的のサービスと国の番号を購入します。残高はその場で引き落とされます。
- コードを含むSMSを取得します。注文の期限までにコードが届かなければ、代金は自動的に返金されま す。
チャージは一度、購入は何度でも。1回のチャージで残高が許すだけの番号を賄えるため、承認を待つのは 最初の購入だけです。
認証
アカウントのフレーズをベアラートークンとして渡してください。別途のAPIキーもログインの呼び出しも なく、フレーズそのものが認証情報です。
Authorization: Bearer YOUR-SEED-PHRASE
カタログのエンドポイントは認証を必要としません。サービス、国、価格はアカウントがなくても参照でき ます。お金と注文に関わるものはすべて、このヘッダーが必要です。
ベースURL
すべてのエンドポイントは次を基準とします:
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 | Authorization ヘッダーのフレーズが欠けているか誤っています |
422 | リクエストは理解できましたが、実行できません |
500 | 当方側の障害 |
422 でよくあるメッセージ:
| メッセージ | 原因 |
|---|---|
insufficient_funds | 残高が価格を下回っています — 先にチャージを作成してください |
unknown service | そのサービスコードは存在しません。サービスの一覧をご覧ください |
unknown country | その国コードは存在しません。国の一覧をご覧ください |
unknown coin | 対応していない通貨です。チャージのエンドポイントをご覧ください |
amount_usd must be between… | チャージは $25–$1000 に制限されています |
レート制限はありますか?
公表している上限はなく、絞るためのAPIキーもありません。とはいえ、エンドポイントをループで呼び 続けることが無料というわけではありません。次の2つは繰り返し問い合わせる前提のもので、特に注意が 必要です。
| エンドポイント | 妥当な間隔 | 理由 |
|---|---|---|
| カタログと価格の照会 | お手元でキャッシュしてください | 価格が変わることは まれで、リクエストのたびにカタログを取り直しても意味がありません。 |
/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
}
実装の全体像はどのようなものですか?
アカウントからコードまで、6回の呼び出しです。以下はすべて実際に動きます。貼り付けて実行してくだ さい。
# 1. アカウントを作成し、フレーズを保存する
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サーバー
同じ操作は https://otpdrop.com/mcp の Model Context Protocol でも、11のツールとしてご利用いただけ
ます。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 | 同じもの、カタログ全体を含む |
よくある質問
OTPDrop のAPIにキーは必要ですか?
いいえ。申請するものも審査もありません。認証情報はアカウントのフレーズで、ベアラートークンとして渡します。カタログのエンドポイントにはそれすら不要です。
OTPDrop のAPIの利用料はいくらですか?
番号そのもの以外の費用はかかりません。定額料金も、呼び出しごとの課金も、最低数量もありません。価格はサイトに表示されているとおりです。
APIはどのプログラミング言語で使えますか?
HTTPSリクエストを送れる言語であれば何でも使えます。ベアラーヘッダー付きの通常のJSON over HTTPですので、SDKのインストールも、当方のバージョンへの追随も必要ありません。
SMSが届かない場合はどうなりますか?
注文は期限が来ると自動的に残高へ返金されます。サイトから早めにキャンセルすることもできます。お支払いいただくのは届いたコードに対してであり、試行に対してではありません。
REST APIとMCPサーバーは同じものですか?
はい、意図的にそうしています。RESTの各エンドポイントはMCPのツール呼び出しをそのまま置き換えたもので、両者が食い違うことはありません。一方を変えれば他方も変わります。お使いのクライアントに合うほうをお選びください。
費用をかけずにAPIを試せますか?
カタログ、価格の照会、アカウントの作成は無料ですので、実装の大部分はチャージの前に書いて確認できます。お金がかかるのは購入だけです。