SMS受信API

JSONのAPIで番号を購入し、認証コードを読み取れます。本人確認はなく、支払いは 暗号資産です。

REST · JSONOpenAPI 3.1 OpenAPI 仕様 →

ここにあるすべての操作は、MCPのツールでもあります。 RESTのエンドポイントは、 MCPサーバーが公開しているのと同じツールを置き換えたものです。したがって自律的な エージェントと通常の実装は同じように振る舞います。AIエージェントを OTPDrop に向けるのであれば、 まずエージェント向けのセクションからご覧ください。

APIはどのように構成されていますか?

  1. アカウントを作成し、返されたフレーズを保存します。それが唯一のアクセス手段で、再設定はできま せん。
  2. チャージを作成し、暗号資産を送金して、反映をお待ちください。
  3. 目的のサービスと国の番号を購入します。残高はその場で引き落とされます。
  4. コードを含む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作成完了 — アカウント、チャージ、注文が存在します
401Authorization ヘッダーのフレーズが欠けているか誤っています
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}/sms3〜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
}

実装の全体像はどのようなものですか?

アカウントからコードまで、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.jsonOpenAPI 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を試せますか?

カタログ、価格の照会、アカウントの作成は無料ですので、実装の大部分はチャージの前に書いて確認できます。お金がかかるのは購入だけです。