API para recibir SMS

Compra números y lee códigos de verificación con una API JSON. Sin KYC, solo criptomonedas.

REST · JSONOpenAPI 3.1 Especificación OpenAPI →

¿Cómo encaja todo en la API?

1. Crea una cuenta y guarda la semilla que devuelve. Es la única credencial y no puede restablecerse.
2. Crea una recarga, envía las criptomonedas y espera a que se acredite.
3. Compra un número para el servicio y el país que necesites: el saldo se descuenta al instante.
4. Consulta el código SMS. Si no llega ninguno antes de que expire el pedido, hay reembolso automático.

Financia una vez, compra muchas: una sola recarga cubre tantos números como permita su saldo, así que solo la primera compra espera una confirmación.

Autenticación

Envía la semilla de la cuenta como token bearer. No hay clave de API aparte ni llamada de inicio de sesión: la semilla es la credencial.

Authorization: Bearer YOUR-SEED-PHRASE

Los endpoints del catálogo no necesitan autenticación en absoluto, así que puedes consultar servicios, países y precios antes de que exista una cuenta. Todo lo que toca dinero o pedidos requiere la cabecera.

URL base

Todos los endpoints son relativos a:

https://otpdrop.com/api/v1

Las respuestas son JSON. Los cuerpos POST se aceptan como application/json o application/x-www-form-urlencoded.

Errores

Los fallos devuelven un estado fuera de 2xx y un único objeto de error.

{
  "error": {
    "code": "invalid_request",
    "message": "unknown service: \"whatsap\""
  }
}

Mensajes habituales con 422:

¿Hay límites de frecuencia?

No hay cuota publicada ni clave de API que estrangular, pero llamar a los endpoints en bucle no sale gratis. Dos de ellos están pensados para consultas repetidas y merecen especial cuidado.

El tráfico que parezca un ataque se bloqueará en el borde sin un 429 de cortesía. Si tienes un motivo legítimo para consultar con más frecuencia, escríbenos primero en la página de contacto.

¿Cómo es una integración completa?

De la cuenta al código en seis llamadas. Todo lo de abajo es real: pégalo y funciona.

# 1. Crear una cuenta y guardar la semilla
SEED=$(curl -s -X POST https://otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Financiarla: envía coin_amount a la dirección devuelta
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. Consultar hasta que el depósito se acredite
curl -s https://otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Comprobar el precio antes de comprometerse
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Comprar: se descuenta el saldo y el número se entrega al momento
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. Consultar el código
until curl -s https://otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

La misma secuencia en Python, sin la shell:

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)

Servidor MCP

Las mismas operaciones están disponibles por Model Context Protocol en https://otpdrop.com/mcp, como once herramientas. Para añadirlo a Claude Code:

claude mcp add --transport http otpdrop https://otpdrop.com/mcp

La configuración y la lista completa de herramientas están en la página para agentes.

Archivos de descubrimiento

Descripciones del servicio legibles por máquinas, todas servidas sin autenticación.

Preguntas frecuentes

¿La API de OTPDrop necesita una clave?

No. No hay nada que solicitar ni ningún paso de aprobación. La credencial es la semilla de la cuenta, enviada como token bearer, y los endpoints del catálogo no necesitan credencial alguna.

¿Cuánto cuesta la API de OTPDrop?

Nada más allá de los números que compres. No hay suscripción, ni coste por llamada, ni volumen mínimo: pagas los mismos precios que quien use la web.

¿Con qué lenguajes de programación funciona la API?

Con cualquiera capaz de hacer una petición HTTPS. Es JSON simple sobre HTTP con una cabecera bearer, así que no hay SDK que instalar ni nada que mantener al día con nuestras versiones.

¿Qué pasa si el código SMS nunca llega?

El pedido se reembolsa solo a tu saldo cuando expira, y puedes cancelarlo antes desde la web. Se te cobra por códigos entregados, no por intentos.

¿La API REST es lo mismo que el servidor MCP?

Sí, deliberadamente. Cada endpoint REST es una traducción de una llamada a una herramienta MCP, así que los dos no pueden separarse: arreglar uno es arreglar el otro. Elige el que le venga mejor a tu cliente.

¿Se puede probar la API sin gastar nada?

El catálogo, las cotizaciones y la creación de cuenta son gratuitos, así que puedes construir y probar casi toda una integración antes de financiar un saldo. Solo comprar cuesta dinero.