Paginación, Filtrado y Ordenación

Domina la recuperación eficiente de datos con paginación, filtrado y ordenación. Aprende a optimizar consultas y reducir llamadas API usando parámetros de consulta.

Paginación

Smart Money API utiliza paginación basada en cursor para una recuperación eficiente de datos. Especifica el número de página y el límite para controlar los conjuntos de resultados.

Parámetro	Tipo	Por Defecto	Máximo
page	integer	1	N/A
limit	integer	50	500

Ejemplo de Paginación

cURL

# Obtener los primeros 100 resultados
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Obtener la segunda página
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Información de Paginación en la Respuesta

JSON

{
  "success": true,
  "data": {...},
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 420,
    "total_pages": 9,
    "has_next": true,
    "has_prev": false
  }
}

Filtrado

Filtra resultados por símbolo, exchange, dirección y otros criterios. Los filtros se combinan con lógica AND.

Filtro	Valores	Ejemplo
symbol	Par de trading	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Número	10.5
min_pnl_percent	Número	2.0

Ejemplo de Filtrado

cURL

# Filtrar por símbolo y dirección
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtrar por exchange y tamaño mínimo de posición
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Ordenación

Ordena resultados por tamaño de posición, P&L u otros campos. Especifica el campo y la dirección (asc/desc).

cURL

# Ordenar por tamaño de posición descendente (mayor primero)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Ordenar por P&L ascendente
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Ejemplos Completos

Python: Iterar a través de Todas las Páginas

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Obtener todas las posiciones de ballenas con paginación"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Tamaño máximo del lote
            "sort": "position_size",
            "order": "desc"
        }

        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            "https://api.smartmoneyapi.com/v1/whales/events",
            headers={"Authorization": f"Bearer {api_key}"},
            params=params
        )

        data = response.json()
        all_positions.extend(data["data"]["positions"])

        # Verificar si hay más páginas
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Uso
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Se encontraron {len(positions)} posiciones de ballenas")

Mejores Prácticas

1. Usa el límite máximo (100-500): Menos llamadas API para recuperar la misma cantidad de datos. Procesa los resultados de manera eficiente.

2. Filtra en el servidor: Usa parámetros de consulta para filtrar en la fuente, no en tu código de aplicación. Reduce la transferencia de datos.

3. Ordena en el servidor: Solicita resultados ordenados desde la API. La ordenación a gran escala es eficiente en el servidor.

4. Cachea y pagina: Cachea los resultados localmente y pagina a través de los datos cacheados para minimizar las llamadas API.

5. Detente temprano si es posible: No siempre recuperes todas las páginas. Detente cuando tengas suficientes datos para tu caso de uso.

Aprende Más

Explora la referencia completa de la API para todas las opciones de filtrado y ordenación.

Ver Referencia de la API REST