Documentación de la API

Retorna todos los servicios registrados con información de precios. No requiere autenticación.

Parámetros de Consulta

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

Descubrimiento mejorado con filtrado, ordenamiento y coincidencia de etiquetas.

Parámetros de Consulta

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

Retorna las categorías de servicios disponibles con conteo de servicios.

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

Retorna el total de llamadas, gasto y latencia promedio para el 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}

Crea una factura de pago cripto vía NOWPayments. Soporta USDT, USDC, BTC, ETH y más de 300 criptomonedas.

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..."}

Después de la confirmación del pago, tu saldo se acredita automáticamente vía webhook IPN.

Cuerpo de la Solicitud

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 conteo de servicios, total de llamadas, ingresos y estado de liquidación para el proveedor autenticado.

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

Retorna todos los servicios del proveedor autenticado con estadísticas de uso.

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

Análisis detallado de un servicio específico: total de llamadas, ingresos, tasa de éxito, desglose diario.

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

Retorna total ganado, liquidado, montos pendientes e historial de liquidaciones.

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

Retorna puntuaciones de salud de todos tus servicios basadas en latencia, tasa de error y tiempo de actividad.

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

Prueba la conectividad con el endpoint de tu servicio. Retorna accesibilidad, latencia y código de estado.

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

Rastrea tu progreso de integración: creación de clave API, registro de servicio, primer tráfico, primera liquidación.

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

Crea una nueva liquidación para un proveedor. Requiere rol 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 las liquidaciones, opcionalmente filtradas por proveedor o estado.

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

Marca una liquidación como pagada y activa la transferencia on-chain.

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

Genera un código de referencia único para el usuario autenticado.

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

Aplica un código de referencia durante el registro para vincular cuentas.

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

Lista todas las referencias realizadas por el usuario autenticado.

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

Estadísticas agregadas de referencias: total de referidos, tasa de conversión y ganancias.

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

Registra un nuevo endpoint de webhook para recibir notificaciones de eventos.

Cuerpo de la Solicitud

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 los webhooks registrados para tu cuenta.

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

Elimina una suscripción de webhook.

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

Retorna el registro de auditoría de seguridad con opciones de filtrado.

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

Estadísticas agregadas de auditoría: conteo de eventos por tipo y período de tiempo.

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