API para desarrolladores

Consulta tu saldo y tus movimientos desde tus propios scripts — una hoja de cálculo, un bot de Telegram, lo que necesites.

🔒 Siempre de solo lectura — nunca puede mover fondos ni cambiar nada de tu cuenta

1Consigue tu clave

Entra en tu cuenta de AmineBot → Mi Cuenta → Seguridad → Claves de API personales → "+ Crear nueva clave". Te la muestra una sola vez — cópiala ahí mismo, porque no se puede volver a ver completa después.

Ir a Mi Cuenta →

2Cómo autenticarte

En cada petición, manda tu clave en la cabecera Authorization, con el prefijo Bearer:

# Sustituye TU_CLAVE por la tuya (empieza por ab_live_...)
curl -H "Authorization: Bearer TU_CLAVE" \
  https://aminebot.com/api/v1/balance

3Consultar tu saldo

GET /api/v1/balance

Devuelve tu saldo total en dólares y el desglose por moneda, con el rendimiento acumulado ya incluido.

curl -H "Authorization: Bearer TU_CLAVE" \
  https://aminebot.com/api/v1/balance

Respuesta:

{
  "total_usd": 1234.56,
  "balances": [
    { "coin": "btc", "amount": 0.02 },
    { "coin": "eth", "amount": 0.5 },
    { "coin": "ueth", "amount": 150.0 },
    { "coin": "uarb", "amount": 0 }
  ]
}

4Consultar tus movimientos

GET /api/v1/transactions

Tus últimos depósitos y retiros, del más reciente al más antiguo.

ParámetroQué hace
limitCuántos movimientos devolver (por defecto 50, máximo 200)
offsetDesde cuál empezar, para pedir la siguiente página de resultados
curl -H "Authorization: Bearer TU_CLAVE" \
  "https://aminebot.com/api/v1/transactions?limit=5"

Respuesta:

[
  {
    "type": "deposit",
    "coin": "btc",
    "amount": 0.01,
    "created_at": 1700000000
  },
  {
    "type": "withdraw",
    "coin": "ueth",
    "amount": 50.0,
    "created_at": 1699000000
  }
]

created_at viene en formato Unix (segundos desde 1970) — la mayoría de lenguajes lo convierten a fecha con una sola función (new Date(created_at * 1000) en JavaScript, datetime.fromtimestamp() en Python).

5Consultar tus direcciones de depósito

GET /api/v1/wallets

Tu dirección de depósito de cada moneda — útil si tu script necesita saber dónde apuntar, sin tener que copiarla a mano desde la web.

curl -H "Authorization: Bearer TU_CLAVE" \
  https://aminebot.com/api/v1/wallets

Respuesta:

[
  { "coin": "btc", "address": "bc1q..." },
  { "coin": "eth", "address": "0x..." }
]

6Consultar los datos básicos de tu cuenta

GET /api/v1/me

Tu usuario, tu nivel actual, desde cuándo tienes la cuenta, tu código de referido, y cuántos referidos directos tienes — sin nada de saldo (para eso está /balance).

curl -H "Authorization: Bearer TU_CLAVE" \
  https://aminebot.com/api/v1/me

Respuesta:

{
  "username": "fernando_alonso",
  "name": "Fernando",
  "lastname": "Alonso",
  "member_since": 1700000000,
  "tier": "Oro",
  "ref_code": "FERNANDO2026",
  "direct_referrals": 3
}

7Límites y errores

SituaciónRespuesta
Clave incorrecta, inventada o ya revocada401 — {"error":"..."}
Más de 120 peticiones en un minuto429

Ese límite es generoso para un script personal — solo frena un uso abusivo, no el uso normal de una automatización tuya comprobando el saldo cada rato.

8Seguridad — leer antes de usar

Tu clave es como una contraseña. No la pegues en chats, capturas de pantalla, repositorios de código públicos, ni la compartas con nadie. Si crees que alguien más pudo verla, revócala inmediatamente desde Mi Cuenta → Seguridad y crea una nueva — es gratis e instantáneo.

Aun siendo de solo lectura, tu saldo y tus movimientos son información privada. Trátala con el mismo cuidado que cualquier otro dato sensible de tu cuenta.

← Volver a AmineBot