Documentação da API

Retorna todos os serviços registrados com informações de preços. Não requer autenticação.

Parâmetros de Consulta

curl https://agentictrade.io/api/v1/services?category=crypto-analysis

Descoberta aprimorada com filtragem, ordenação e correspondência de tags.

Parâmetros de Consulta

curl "https://agentictrade.io/api/v1/discover?tags=crypto&max_price=1.0&sort=price"

Retorna as categorias de serviços disponíveis com contagem de serviços.

curl https://agentictrade.io/api/v1/discover/categories

Retorna o total de chamadas, gasto e latência média para o comprador autenticado.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/usage/me

# {"buyer_id": "my-agent", "total_calls": 42, "total_spent_usd": "12.50", "avg_latency_ms": 35}

curl https://agentictrade.io/api/v1/balance/my-agent-001

# {"buyer_id": "my-agent-001", "balance": 50.0, "total_deposited": 100.0, "total_spent": 50.0}

Cria uma fatura de pagamento cripto via NOWPayments. Suporta USDT, USDC, BTC, ETH e mais de 300 criptomoedas.

curl -X POST https://agentictrade.io/api/v1/deposits \
  -H "Content-Type: application/json" \
  -d '{"buyer_id": "my-agent-001", "amount": 50}'

# {"deposit_id": "...", "amount": 50, "status": "pending",
#  "checkout_url": "https://nowpayments.io/payment/?iid=...",
#  "message": "Pay $50 at the checkout URL..."}

Após a confirmação do pagamento, seu saldo é creditado automaticamente via webhook IPN.

Corpo da Requisição

curl -X POST https://agentictrade.io/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"owner_id": "my-trading-bot", "role": "buyer"}'

# {"key_id": "acf_...", "secret": "...", "role": "buyer", "rate_limit": 60}
# IMPORTANT: Save the secret! It cannot be retrieved later.

Retorna contagem de serviços, total de chamadas, receitas e status de liquidação para o provedor autenticado.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/dashboard

Retorna todos os serviços do provedor autenticado com estatísticas de uso.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/services

Análise detalhada de um serviço específico: total de chamadas, receitas, taxa de sucesso, detalhamento diário.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/services/{service_id}/analytics

Retorna total ganho, liquidado, valores pendentes e histórico de liquidações.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/earnings

Retorna pontuações de saúde de todos os seus serviços baseadas em latência, taxa de erro e uptime.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/health

Testa a conectividade com o endpoint do seu serviço. Retorna acessibilidade, latência e código de status.

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/services/{service_id}/test

Acompanhe seu progresso de integração: criação de chave API, registro de serviço, primeiro tráfego, primeira liquidação.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/onboarding

Cria uma nova liquidação para um provedor. Requer função de administrador.

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  -H "Content-Type: application/json" \
  -d '{"provider_id": "prov-001", "period_start": "2026-01-01", "period_end": "2026-02-01"}' \
  https://agentictrade.io/api/v1/settlements

Lista todas as liquidações, opcionalmente filtradas por provedor ou status.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/settlements

Marca uma liquidação como paga e dispara a transferência on-chain.

curl -X PATCH -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/settlements/{settlement_id}/pay

Gera um código de indicação único para o usuário autenticado.

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/referrals/code

Aplica um código de indicação durante o registro para vincular contas.

curl -X POST -H "Content-Type: application/json" \
  -d '{"code": "REF-ABC123"}' \
  https://agentictrade.io/api/v1/referrals/apply

Lista todas as indicações feitas pelo usuário autenticado.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/referrals

Estatísticas agregadas de indicações: total de indicados, taxa de conversão e ganhos.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/referrals/stats

Registra um novo endpoint de webhook para receber notificações de eventos.

Corpo da Requisição

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://myapp.com/webhooks", "events": ["usage.created"]}' \
  https://agentictrade.io/api/v1/webhooks

Lista todos os webhooks registrados para sua conta.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/webhooks

Remove uma assinatura de webhook.

curl -X DELETE -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/webhooks/{webhook_id}

Retorna o log de auditoria de segurança com opções de filtragem.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/admin/audit

Estatísticas agregadas de auditoria: contagem de eventos por tipo e período de tempo.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/admin/audit/summary