Documentação da API

Guia de Testes de API e Ambiente Sandbox

Domine os testes com o ambiente sandbox completo da Smart Money API. Desenvolva sem riscos usando dados de teste realistas, respostas determinísticas e limites de taxa generosos para experimentação.

Publicado em 21 de março de 2026 • 14 minutos de leitura • Desenvolvimento

Visão Geral do Ambiente Sandbox

A Smart Money API fornece um ambiente sandbox completo para desenvolvimento e testes. O sandbox espelha a estrutura da API de produção, mas usa dados sintéticos e limites de taxa generosos, permitindo que você desenvolva com confiança antes de ir para produção.

Características principais:

  • Idêntico à Produção — Mesmos endpoints, autenticação, formato de resposta
  • Apenas Dados de Teste — Nunca afeta contas reais ou mercados ao vivo
  • Limites de Taxa Altos — 10.000 solicitações/hora vs 1.000 em produção
  • Respostas Determinísticas — Fixtures de teste consistentes para testes reproduzíveis
  • Contas Isoladas — Separadas dos dados de usuário de produção

Melhor Prática: Todo desenvolvimento, teste e staging deve usar o ambiente sandbox. Use a produção apenas após uma validação completa no sandbox.

Recursos do Sandbox

Dados de Teste Realistas

O sandbox contém dados de mercado de criptomoedas realistas que não mudam aleatoriamente:

  • Dados históricos de mercado (6 meses de OHLCV realista)
  • Endereços de carteira de baleia fixos com padrões de movimento consistentes
  • Taxas de financiamento estáveis que são redefinidas a cada hora
  • Padrões de liquidação determinísticos para testar casos extremos

Recursos Específicos para Testes

Recursos de Teste
// Símbolos de teste determinísticos
// Todos os símbolos de teste começam com TEST_
TEST_BTC, TEST_ETH, TEST_SOL, etc.
// Timestamps mágicos para simular cenários
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Retorna dados de teste fixos
// Forçar erros para testar tratamento de exceções
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Utilitários de Teste

  • Redefinição de Dados — Redefinir todas as contas de teste para o estado inicial
  • Controle de Tempo — Simular diferentes condições de mercado
  • Injeção de Erros — Forçar respostas de erro específicas
  • Teste de Limite de Taxa — Acionar respostas de limite de taxa
Obtenha sua chave de API em 30 segundos

Pronto para construir? Obtenha uma chave de API gratuita (200 chamadas/dia, sem cartão) e comece a puxar dados ao vivo de baleias, financiamento e on-chain.

Obtenha sua chave de API →

Credenciais de Teste

Obtendo Chaves de API de Teste

Crie uma conta de teste através do painel para gerar chaves de API do sandbox:

Formato da Chave de Teste
// As chaves de teste têm um prefixo diferente
sk_test_1234567890abcdef // Chave de API de teste
sk_live_1234567890abcdef // Chave de API de produção
// Roteia automaticamente para o ambiente apropriado
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Roteia para o sandbox automaticamente

Chaves de Teste Pré-configuradas

Use estas chaves de teste públicas para experimentação rápida (limitadas por taxa):

Chave Permissões Limite
sk_test_demo Leitura total 100/hora
sk_test_trader Leitura + alertas 500/hora
sk_test_pro Acesso total 5000/hora

Nunca use chaves de teste em produção. Elas têm funcionalidade limitada e limites de taxa.

Dados e Fixtures de Teste

Símbolos de Teste Disponíveis

O sandbox inclui estes pares de negociação de teste com dados históricos realistas:

Símbolos de Teste
// Pares de criptomoedas
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Consultar símbolos de teste
GET /v1/symbols?test_only=true

Carteiras de Baleia de Teste

Carteiras de teste pré-configuradas com comportamento determinístico:

  • Carteira Acumuladora — Compra consistentemente, ideal para testes de alta
  • Carteira Distribuidora — Vende consistentemente, ideal para testes de baixa
  • Carteira Osciladora — Alterna compra/venda, ideal para testes de intervalo
  • Carteira Volátil — Transações grandes aleatórias para testes de estresse

Redefinição de Dados de Teste

Redefinir Dados de Teste
// Redefinir todas as contas de teste para o estado inicial
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Redefinir recurso específico
POST /v1/test/reset?resource=whales
// Resposta
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Endpoints do Sandbox

URLs Base

URLs de Ambiente
// Sandbox (modo de teste)
https://api-test.smartmoney.io/v1
// Ou use parâmetro de consulta
https://api.smartmoneyapi.com/v1?environment=sandbox
// Produção (modo real)
https://api.smartmoneyapi.com/v1

Endpoints Exclusivos do Sandbox

Endpoint Propósito
POST /test/reset Redefinir dados de teste para o estado inicial
POST /test/inject-error Injetar erro específico para teste
POST /test/simulate-time Simular diferentes condições de mercado
GET /test/status Verificar a saúde do ambiente sandbox

Simulação de Resposta

Injeção de Erros de Teste

Forçar respostas de erro específicas para teste de tratamento de exceções:

Injeção de Erro
// Testar tratamento de limite de taxa
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Testar indisponibilidade de serviço
GET /v1/whales?X-Test-Error=service_unavailable
// Testar falha de autenticação
GET /v1/whales?X-Test-Error=invalid_key
// Testar tempo limite
GET /v1/whales?X-Test-Error=timeout

Erros de Teste Disponíveis

Código de Erro Status HTTP Caso de Uso
invalid_key 401 Tratamento de erro de autenticação
rate_limit_exceeded 429 Teste de lógica de recuo
not_found 404 Tratamento de recurso ausente
service_unavailable 503 Teste de lógica de repetição
timeout 504 Tratamento de tempo limite

Limites de Taxa do Sandbox

Níveis de Limite de Taxa

Ambiente Limite/Hora Rajada Propósito
Sandbox 10,000 500/min Desenvolvimento e teste
Produção Grátis 1,000 50/min Projetos pessoais
Produção Trader 10,000 400/min Negociação profissional
Produção Pro 50,000 1000/min Sistemas de alta frequência

Teste de Tratamento de Limite de Taxa

Teste de Limite de Taxa
// Acionar resposta de limite de taxa no sandbox
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// A resposta inclui cabeçalhos de repetição
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Estratégias de Teste

Teste de Unidade com Fixtures

Teste de Unidade em 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())

Teste de Integração

Testar fluxo completo no sandbox antes da implantação em produção:

  1. Implantar em staging com credenciais sandbox
  2. Executar suíte de testes completa no sandbox
  3. Testar tratamento de erros com injeção de erros
  4. Verificar comportamento de limite de taxa
  5. Verificar tempo de resposta e latência
  6. Só então promover para produção

Teste de Carga

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

Integração CI/CD

Exemplo 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/

Configuração de Ambiente

Use variáveis de ambiente para alternar entre sandbox e produção:

Configuração do Ambiente
// .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

Solução de Problemas

Problemas Comuns

Chave de Teste Não Funciona

Problema: Recebendo 401 Não Autorizado com a chave de teste

Soluções:

  • Verifique se a chave começa com sk_test_ (não sk_live_)
  • Verifique o formato do cabeçalho de Autorização: "Bearer sk_test_xxx"
  • Certifique-se de usar o endpoint de teste: api-test.smartmoney.io
  • A chave de teste pode ter excedido o limite de taxa

Dados Não Reiniciam

Problema: Os dados de teste não reiniciam após POST /test/reset

Soluções:

  • O reinício pode levar até 30 segundos para propagar
  • Verifique o status do sandbox com GET /test/status
  • Confirme se está usando a chave de API de teste correta
  • Contate o suporte se persistir

Limites de Taxa no Sandbox

Problema: Atingindo limites de taxa no sandbox (não deveria acontecer)

Soluções:

  • Verifique se está usando a chave sk_test_pro (10.000/hora)
  • Verifique o cabeçalho X-RateLimit-Remaining
  • Aguarde o limite da hora ou use uma conta de teste diferente
  • Contate o suporte para um aumento temporário do limite de taxa

Comece a Testar Hoje

Use nosso ambiente sandbox abrangente para desenvolvimento seguro e isolado. Dados de teste determinísticos, altos limites de taxa e paridade completa de recursos com a produção.

Obtenha Credenciais de Teste
Todos os planos incluem acesso ao sandbox. Sem custo adicional.

Recursos Relacionados

Guia de Autenticação →

Autenticação de API e gerenciamento de chaves

Referência da API REST →

Documentação completa dos endpoints da API

Códigos de Erro →

Tratamento de erros e códigos de resposta
Comece grátis — 200 chamadas/dia, sem cartão

Obtenha dados de fluxo de baleias, financiamento, interesse aberto e on-chain em 3 exchanges a partir de uma única API. Camada gratuita, sem cartão de crédito, atualize a qualquer momento.

Comece grátis →
Experimente o console da API ao vivo → (sem conta necessária)