Paginação, Filtragem e Ordenação

Domine a recuperação eficiente de dados com paginação, filtragem e ordenação. Aprenda a otimizar consultas e reduzir chamadas de API usando parâmetros de consulta.

Paginação

A Smart Money API utiliza paginação baseada em cursor para recuperação eficiente de dados. Especifique o número da página e o limite para controlar os conjuntos de resultados.

Parâmetro	Tipo	Padrão	Máximo
page	integer	1	N/A
limit	integer	50	500

Exemplo de Paginação

cURL

# Obter os primeiros 100 resultados
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

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

Informações de Paginação na Resposta

JSON

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

Filtragem

Filtre resultados por símbolo, exchange, direção e outros critérios. Os filtros são combinados com lógica AND.

Filtro	Valores	Exemplo
symbol	Par de negociação	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

Exemplo de Filtragem

cURL

# Filtrar por símbolo e direção
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtrar por exchange e tamanho mínimo de posição
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Ordenação

Ordene os resultados por tamanho de posição, P&L ou outros campos. Especifique o campo e a direção (asc/desc).

cURL

# Ordenar por tamanho de posição decrescente (maiores primeiro)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

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

Exemplos Completos

Python: Iterar por Todas as Páginas

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Buscar todas as posições de baleias com paginação"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Tamanho máximo do 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 se há mais 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"Encontradas {len(positions)} posições de baleias")

Melhores Práticas

1. Use o limite máximo (100-500): Menos chamadas de API para recuperar a mesma quantidade de dados. Agrupe os resultados de forma eficiente.

2. Filtre no servidor: Use parâmetros de consulta para filtrar na origem, não no código do seu aplicativo. Reduz a transferência de dados.

3. Ordene no servidor: Solicite resultados ordenados da API. A ordenação em escala é eficiente no servidor.

4. Armazene em cache e pagine: Armazene os resultados localmente e pagine pelos dados em cache para minimizar as chamadas de API.

5. Pare cedo, se possível: Nem sempre busque todas as páginas. Pare quando tiver dados suficientes para o seu caso de uso.

Saiba Mais

Explore a referência completa da API para todas as opções de filtragem e ordenação.

Ver Referência da API REST