Documentación de la API

Guía de Pruebas de API y Entorno de Sandbox

Domina las pruebas con el entorno de sandbox completo de Smart Money API. Desarrolla sin riesgos utilizando datos de prueba realistas, respuestas determinísticas y límites de tasa generosos para la experimentación.

Publicado el 21 de marzo de 2026 • 14 minutos de lectura • Desarrollo

Resumen del Entorno de Sandbox

Smart Money API proporciona un entorno de sandbox completo para desarrollo y pruebas. El sandbox refleja la estructura de la API de producción pero utiliza datos sintéticos y límites de tasa generosos, permitiéndote desarrollar con confianza antes de pasar a producción.

Características clave:

  • Idéntico a Producción — Mismos endpoints, autenticación, formato de respuesta
  • Solo Datos de Prueba — Nunca afecta cuentas reales o mercados en vivo
  • Límites de Tasa Altos — 10,000 solicitudes/hora frente a 1,000 en producción
  • Respuestas Determinísticas — Fixtures de prueba consistentes para pruebas reproducibles
  • Cuentas Aisladas — Separadas de los datos de usuario de producción

Mejor Práctica: Todo el desarrollo, pruebas y puesta en escena deben usar el entorno de sandbox. Solo usa producción después de una validación exhaustiva en el sandbox.

Características del Sandbox

Datos de Prueba Realistas

El sandbox contiene datos de mercado de criptomonedas realistas que no cambian aleatoriamente:

  • Datos históricos de mercado (6 meses de OHLCV realista)
  • Direcciones de billeteras de ballenas fijas con patrones de movimiento consistentes
  • Tasas de financiamiento estables que se reinician cada hora
  • Patrones de liquidación determinísticos para probar casos extremos

Características Específicas de Prueba

Características de Prueba
// Símbolos de prueba determinísticos
// Todos los símbolos de prueba comienzan con TEST_
TEST_BTC, TEST_ETH, TEST_SOL, etc.
// Marcas de tiempo mágicas para simular escenarios
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Devuelve datos de prueba fijos
// Forzar errores para pruebas de manejo de excepciones
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Utilidades de Prueba

  • Reinicio de Datos — Reinicia todas las cuentas de prueba al estado inicial
  • Control de Tiempo — Simula diferentes condiciones de mercado
  • Inyección de Errores — Fuerza respuestas de error específicas
  • Pruebas de Límite de Tasa — Activa respuestas de límite de tasa
Obtén tu clave API en 30 segundos

¿Listo para construir? Obtén una clave API gratuita (200 llamadas/día, sin tarjeta) y comienza a obtener datos en vivo de ballenas, financiamiento y cadena de bloques.

Obtén tu clave API →

Credenciales de Prueba

Obtención de Claves API de Prueba

Crea una cuenta de prueba a través del panel para generar claves API de sandbox:

Formato de Clave de Prueba
// Las claves de prueba tienen un prefijo diferente
sk_test_1234567890abcdef // Clave API de prueba
sk_live_1234567890abcdef // Clave API de producción
// Enruta automáticamente al entorno apropiado
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Enruta al sandbox automáticamente

Claves de Prueba Preconfiguradas

Usa estas claves de prueba públicas para experimentación rápida (con límite de tasa):

Clave Permisos Límite
sk_test_demo Lectura total 100/hora
sk_test_trader Lectura + alertas 500/hora
sk_test_pro Acceso completo 5000/hora

Nunca uses claves de prueba en producción. Tienen funcionalidad limitada y límites de tasa.

Datos y Fixtures de Prueba

Símbolos de Prueba Disponibles

El sandbox incluye estos pares de trading de prueba con datos históricos realistas:

Símbolos de Prueba
// Pares de criptomonedas
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Consulta símbolos de prueba
GET /v1/symbols?test_only=true

Billeteras de Ballenas de Prueba

Billeteras de prueba preconfiguradas con comportamiento determinístico:

  • Billetera Acumuladora — Compra consistentemente, ideal para pruebas alcistas
  • Billetera Distribuidora — Vende consistentemente, ideal para pruebas bajistas
  • Billetera Osciladora — Alterna compra/venta, ideal para pruebas en rango
  • Billetera de Volatilidad — Transacciones grandes aleatorias para pruebas de estrés

Reinicio de Datos de Prueba

Reiniciar Datos de Prueba
// Reinicia todas las cuentas de prueba al estado inicial
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Reinicia un recurso específico
POST /v1/test/reset?resource=whales
// Respuesta
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Puntos de conexión de Sandbox

URLs base

URLs de entorno
// Sandbox (modo de prueba)
https://api-test.smartmoney.io/v1
// O usar parámetro de consulta
https://api.smartmoneyapi.com/v1?environment=sandbox
// Producción (modo en vivo)
https://api.smartmoneyapi.com/v1

Puntos de conexión exclusivos de Sandbox

Punto de conexión Propósito
POST /test/reset Restablecer datos de prueba al estado inicial
POST /test/inject-error Inyectar error específico para pruebas
POST /test/simulate-time Simular diferentes condiciones de mercado
GET /test/status Verificar el estado del entorno sandbox

Simulación de respuestas

Inyección de errores de prueba

Forzar respuestas de error específicas para pruebas de manejo de excepciones:

Inyección de errores
// Probar manejo de límite de tasa
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Probar indisponibilidad del servicio
GET /v1/whales?X-Test-Error=service_unavailable
// Probar fallo de autenticación
GET /v1/whales?X-Test-Error=invalid_key
// Probar tiempo de espera agotado
GET /v1/whales?X-Test-Error=timeout

Errores de prueba disponibles

Código de error Estado HTTP Caso de uso
invalid_key 401 Manejo de errores de autenticación
rate_limit_exceeded 429 Pruebas de lógica de retroceso
not_found 404 Manejo de recursos faltantes
service_unavailable 503 Pruebas de lógica de reintento
timeout 504 Manejo de tiempo de espera agotado

Límites de tasa en Sandbox

Niveles de límite de tasa

Entorno Límite/Hora Ráfaga Propósito
Sandbox 10,000 500/min Desarrollo y pruebas
Producción Gratis 1,000 50/min Proyectos personales
Producción Trader 10,000 400/min Operaciones profesionales
Producción Pro 50,000 1000/min Sistemas de alta frecuencia

Pruebas de manejo de límite de tasa

Pruebas de límite de tasa
// Provocar respuesta de límite de tasa en sandbox
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// La respuesta incluye encabezados de reintento
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Estrategias de prueba

Pruebas unitarias con fixtures

Prueba unitaria en Python
import unittest
import requests
class TestSmartMoneyAPI(unittest.TestCase):
def setUp(self):
self.api_key = 'sk_test_demo'
self.base_url = 'https://api-test.smartmoney.io/v1'
def test_whale_tracking(self):
response = requests.get(
f'{self.base_url}/whales/TEST_BTC',
headers={'Authorization': f'Bearer {self.api_key}'}
)
self.assertEqual(response.status_code, 200)
self.assertIn('whales', response.json())

Pruebas de integración

Probar flujo completo en sandbox antes del despliegue en producción:

  1. Desplegar en staging con credenciales sandbox
  2. Ejecutar suite completa de pruebas en sandbox
  3. Probar manejo de errores con inyección de errores
  4. Verificar comportamiento de límite de tasa
  5. Verificar tiempo de respuesta y latencia
  6. Solo entonces pasar a producción

Pruebas de carga

Prueba de carga con Apache Bench
// Sandbox permite pruebas de alta carga
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

Integración CI/CD

Ejemplo de GitHub Actions

.github/workflows/test.yml
name: API Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- run: pip install requests pytest
- env:
SMARTMONEY_API_KEY: ${{ secrets.TEST_API_KEY }}
SMARTMONEY_ENV: sandbox
run: pytest tests/

Configuración de entorno

Usa variables de entorno para cambiar entre el entorno de pruebas y producción:

Configuración del Entorno
// .env.sandbox
SMARTMONEY_API_KEY=sk_test_demo
SMARTMONEY_API_URL=https://api-test.smartmoney.io/v1
SMARTMONEY_ENV=sandbox
// .env.production
SMARTMONEY_API_KEY=sk_live_xxxx
SMARTMONEY_API_URL=https://api.smartmoneyapi.com/v1
SMARTMONEY_ENV=production

Solución de Problemas

Problemas Comunes

Clave de Prueba No Funciona

Problema: Recibiendo error 401 No Autorizado con la clave de prueba

Soluciones:

  • Verifica que la clave comience con sk_test_ (no sk_live_)
  • Revisa el formato del encabezado Authorization: "Bearer sk_test_xxx"
  • Asegúrate de usar el endpoint de prueba: api-test.smartmoney.io
  • La clave de prueba puede haber excedido el límite de tasa

Datos No Se Reinician

Problema: Los datos de prueba no se reinician después de POST /test/reset

Soluciones:

  • El reinicio puede tardar hasta 30 segundos en propagarse
  • Verifica el estado del entorno de pruebas con GET /test/status
  • Confirma que estás usando la clave de prueba correcta
  • Contacta al soporte si persiste el problema

Límites de Tasa en el Entorno de Pruebas

Problema: Alcanzando límites de tasa en el entorno de pruebas (no debería ocurrir)

Soluciones:

  • Verifica que estés usando la clave sk_test_pro (10,000/hora)
  • Revisa el encabezado X-RateLimit-Remaining
  • Espera al cambio de hora o usa una cuenta de prueba diferente
  • Contacta al soporte para un aumento temporal del límite de tasa

Comienza a Probar Hoy

Usa nuestro entorno de pruebas completo para un desarrollo seguro y aislado. Datos de prueba determinísticos, altos límites de tasa y paridad completa de características con producción.

Obtén Credenciales de Prueba
Todos los planes incluyen acceso al entorno de pruebas. Sin costo adicional.

Recursos Relacionados

Guía de Autenticación →

Autenticación de API y gestión de claves

Referencia de API REST →

Documentación completa de endpoints de la API

Códigos de Error →

Manejo de errores y códigos de respuesta
Comienza gratis — 200 llamadas/día, sin tarjeta

Obtén datos de flujo de ballenas, financiamiento, interés abierto y on-chain en 3 exchanges desde una sola API. Plan gratuito, sin tarjeta de crédito, actualiza cuando quieras.

Comienza gratis →
Prueba la consola de API en vivo → (no se necesita cuenta)