Referencia de la API

Recargas con criptomonedas

Actualizado en octubre de 2026

Recarga el saldo con criptomonedas: obtén la dirección de depósito y el importe exacto, envía exactamente ese importe, informa que el pago se ha enviado (el ID de transacción es opcional) y luego consulta el estado de la recarga hasta que se acredite el saldo. El saldo sirve para pagar cualquiera de nuestros planes.

8 min de lectura

Endpoints de esta página

GET /v1/catalog/coins: Criptomonedas y redes aceptadas (con su dirección de depósito fija)
POST /v1/topups: Iniciar una recarga de saldo con criptomonedas (dirección fija, importe exacto)
POST /v1/topups/{topUpId}/txid: Notificar que se ha enviado el pago (TXID opcional)
GET /v1/topups/{topUpId}: Consultar una recarga (comprobar su estado en tiempo real)
GET /v1/topups: Listar las recargas con criptomonedas

URL base https://localserpproxy.com/api/v1. Para consultar la autenticación, los errores y los límites, consulta la descripción general de la API.

Criptomonedas y redes aceptadas (con su dirección de depósito fija)

GET/v1/catalog/coins

Público: no se necesita una clave de API.

Respuesta `200 OK`

{
  "data": [
    {
      "code": "BTC",
      "name": "Bitcoin",
      "networks": [
        {
          "id": "bitcoin",
          "name": "Bitcoin",
          "confirmationsRequired": 2,
          "estimatedMinutes": null,
          "memoRequired": false,
          "address": "DEPOSIT_ADDRESS"
        }
      ]
    }
  ]
}

Ejemplos de código

curl

curl -s "https://localserpproxy.com/api/v1/catalog/coins"

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"

r = requests.get(f"{API}/catalog/coins", timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/catalog/coins`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Iniciar una recarga de saldo con criptomonedas (dirección fija, importe exacto)

POST/v1/topups

amountUsd ≥ 25.00 USD y ≤ el máximo (10,000.00 de forma predeterminada): 422 en amountUsd; de lo contrario, coin + network deben ser uno de GET /v1/catalog/coins (de lo contrario, 409 coin_unavailable).
Devuelve el address fijo de la red y el importe exacto de amountCrypto = amountUsd / rate, redondeado hacia arriba según la precisión de la criptomoneda (BTC/LTC/ETH/SOL: 8 decimales; USDT/USDC: 6), más un pequeño ajuste único en los últimos dígitos para que dos recargas abiertas de la misma red no soliciten el mismo importe. rate queda bloqueado hasta expiresAt (30 minutos); txidDeadline = expiresAt + 72 h.
purchase opcional (mismo cuerpo que POST /v1/orders): se valida y se calcula el precio ahora (422 con los nombres de campo precedidos por purchase., 409 plan_unavailable…). amountUsd debe cubrir el total de purchase − el saldo actual (422 too_small en amountUsd). Cuando se acredita la recarga, el pedido se realiza con el saldo en la misma transacción; purchase.status pasa a ser completed (con orderId) o failed (failureReason; los fondos permanecen en el saldo).

Autenticación: clave de API en el encabezado Authorization: Bearer API_KEY.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
`Idempotency-Key`	header	string	No	Clave única (p. ej., un UUID) para reintentar un POST de forma segura. Se conserva durante 24 h. — máx. 128 caracteres

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
`amountUsd`	string (USD, 2 decimals)	Sí	USD para añadir: ≥ 25.00, ≤ 10,000.00 de forma predeterminada.
`coin`	string	Sí	—
`network`	string	Sí	—
`purchase`	object	No	Planifica comprar con el saldo cuando se acredite la recarga (mismo cuerpo que `POST /v1/orders`).

Ejemplo: Saldo

{
  "amountUsd": "50.00",
  "coin": "USDT",
  "network": "tron"
}

Ejemplo: Pagar

{
  "amountUsd": "25.00",
  "coin": "BTC",
  "network": "bitcoin",
  "purchase": {
    "planId": "res-10",
    "quantity": 1
  }
}

Respuesta `201 Created`

{
  "id": "top_7d2kq9x1",
  "status": "verifying",
  "final": false,
  "amountUsd": "25.00",
  "coin": "USDT",
  "network": "tron",
  "address": "DEPOSIT_ADDRESS",
  "amountCrypto": "25.000137",
  "rate": "1.00",
  "paymentUri": "PAYMENT_URI",
  "expiresAt": "2026-10-05T14:33:11Z",
  "txidDeadline": "2026-10-08T14:33:11Z",
  "confirmationsRequired": 20,
  "confirmations": 7,
  "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "txidSubmittedAt": "2026-10-05T14:09:42Z",
  "amountReceivedCrypto": "25.000137",
  "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "creditedUsd": null,
  "creditedAt": null,
  "rejection": null,
  "purchase": {
    "planId": "res-10",
    "planName": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Ejemplos de código

curl

curl -s -X POST "https://localserpproxy.com/api/v1/topups" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"amountUsd":"50.00","coin":"USDT","network":"tron"}'

Python

import os, uuid
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}

r = requests.post(f"{API}/topups", headers=HEADERS, json={"amountUsd": "50.00", "coin": "USDT", "network": "tron"}, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
import { randomUUID } from 'node:crypto';

const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Idempotency-Key': randomUUID(), 'Content-Type': 'application/json' },
  body: JSON.stringify({ amountUsd: '50.00', coin: 'USDT', network: 'tron' }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Informar que el pago se ha enviado (TXID opcional)

POST/v1/topups/{topUpId}/txid

Informa que el pago se ha enviado una vez que haya salido de tu monedero o exchange: esta es la versión de la API del botón «He enviado el pago». El ID de transacción (TXID) es opcional: envía un cuerpo vacío ({}) o añade txid si lo tienes. El pago se vincula a esta recarga por su importe exacto (amountCrypto), en la red y dirección de la recarga, así que envía exactamente ese importe.

Se acepta mientras la recarga esté awaiting_payment, expired o rejected, y antes de txidDeadline (expiresAt + 72 h): informar del pago tarde nunca hace que se pierda. Si se proporciona un txid, se comprueba que tenga el formato de la red (422 en txid) y que no se haya asociado a otra recarga (409 txid_already_used). Una recarga cerrada devuelve 409 topup_closed. A continuación, la recarga queda verifying mientras se comprueba el pago en la blockchain y pasa a credited cuando la red confirma la transacción, o a rejected (con rejection).

Autenticación: clave de API en el encabezado Authorization: Bearer API_KEY.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
`topUpId`	path	string	Sí	—

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
`txid`	string	No	Opcional. Hash de transacción: 64 caracteres hexadecimales (bitcoin, litecoin, tron), 0x + 64 caracteres hexadecimales (ethereum), firma base58 (solana). Vacío o ausente: el pago se vincula por su importe exacto. — máx. 128 caracteres

Ejemplo: Pago enviado

{}

Ejemplo: Con el TXID (opcional)

{
  "txid": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}

Respuesta `200 OK`

{
  "id": "top_7d2kq9x1",
  "status": "verifying",
  "final": false,
  "amountUsd": "25.00",
  "coin": "USDT",
  "network": "tron",
  "address": "DEPOSIT_ADDRESS",
  "amountCrypto": "25.000137",
  "rate": "1.00",
  "paymentUri": "PAYMENT_URI",
  "expiresAt": "2026-10-05T14:33:11Z",
  "txidDeadline": "2026-10-08T14:33:11Z",
  "confirmationsRequired": 20,
  "confirmations": 7,
  "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "txidSubmittedAt": "2026-10-05T14:09:42Z",
  "amountReceivedCrypto": "25.000137",
  "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "creditedUsd": null,
  "creditedAt": null,
  "rejection": null,
  "purchase": {
    "planId": "res-10",
    "planName": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Ejemplos de código

curl

curl -s -X POST "https://localserpproxy.com/api/v1/topups/top_7d2kq9x1/txid" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.post(f"{API}/topups/top_7d2kq9x1/txid", headers=HEADERS, json={}, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups/top_7d2kq9x1/txid`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Consultar una recarga (para ver su estado en tiempo real)

GET/v1/topups/{topUpId}

Consulta esta ruta para seguir una recarga: cada 10 s mientras status = verifying, cada 30 s mientras espera el pago y detente cuando final = true. Una recarga pasa a expired si no se informó que el pago se había enviado antes de expiresAt; aún se puede informar hasta txidDeadline.

Autenticación: clave de API en el encabezado Authorization: Bearer API_KEY.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
`topUpId`	path	string	Sí	—

Respuesta `200 OK`

{
  "id": "top_7d2kq9x1",
  "status": "verifying",
  "final": false,
  "amountUsd": "25.00",
  "coin": "USDT",
  "network": "tron",
  "address": "DEPOSIT_ADDRESS",
  "amountCrypto": "25.000137",
  "rate": "1.00",
  "paymentUri": "PAYMENT_URI",
  "expiresAt": "2026-10-05T14:33:11Z",
  "txidDeadline": "2026-10-08T14:33:11Z",
  "confirmationsRequired": 20,
  "confirmations": 7,
  "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "txidSubmittedAt": "2026-10-05T14:09:42Z",
  "amountReceivedCrypto": "25.000137",
  "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "creditedUsd": null,
  "creditedAt": null,
  "rejection": null,
  "purchase": {
    "planId": "res-10",
    "planName": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Ejemplos de código

curl

curl -s "https://localserpproxy.com/api/v1/topups/top_7d2kq9x1" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/topups/top_7d2kq9x1", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups/top_7d2kq9x1`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Listar recargas con criptomonedas

GET/v1/topups

Autenticación: clave de API en el encabezado Authorization: Bearer API_KEY.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
`page`	query	integer	No	≥ 1, predeterminado `1`
`perPage`	query	integer	No	1–100, predeterminado `20`
`status`	query	`awaiting_payment` · `verifying` · `credited` · `rejected` · `expired`	No	`final` = acreditada, o vencida / rechazada después de `txidDeadline`.

Respuesta `200 OK`

{
  "data": [
    {
      "id": "top_7d2kq9x1",
      "status": "verifying",
      "final": false,
      "amountUsd": "25.00",
      "coin": "USDT",
      "network": "tron",
      "address": "DEPOSIT_ADDRESS",
      "amountCrypto": "25.000137",
      "rate": "1.00",
      "paymentUri": "PAYMENT_URI",
      "expiresAt": "2026-10-05T14:33:11Z",
      "txidDeadline": "2026-10-08T14:33:11Z",
      "confirmationsRequired": 20,
      "confirmations": 7,
      "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
      "txidSubmittedAt": "2026-10-05T14:09:42Z",
      "amountReceivedCrypto": "25.000137",
      "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
      "creditedUsd": null,
      "creditedAt": null,
      "rejection": null,
      "purchase": {
        "planId": "res-10",
        "planName": "Local team",
        "quantity": 1,
        "options": {},
        "promoCode": null,
        "total": "7.50",
        "status": "pending",
        "orderId": null,
        "failureReason": null
      },
      "createdAt": "2026-10-05T14:03:11Z"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "totalPages": 1
  }
}

Ejemplos de código

curl

curl -s "https://localserpproxy.com/api/v1/topups" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/topups", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Criptomonedas y redes aceptadas (con su dirección de depósito fija)

Respuesta 200 OK

Ejemplos de código

Iniciar una recarga de saldo con criptomonedas (dirección fija, importe exacto)

Parámetros

Cuerpo de la solicitud

Respuesta 201 Created

Ejemplos de código

Informar que el pago se ha enviado (TXID opcional)

Parámetros

Cuerpo de la solicitud

Respuesta 200 OK

Ejemplos de código

Consultar una recarga (para ver su estado en tiempo real)

Parámetros

Respuesta 200 OK

Ejemplos de código

Listar recargas con criptomonedas

Parámetros

Respuesta 200 OK

Ejemplos de código

Páginas relacionadas

Respuesta `200 OK`

Respuesta `201 Created`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `200 OK`