Pipeline de API: ver tu gasto en IA

Objetivo: ver cuánto cuesta la IA de tus oráculos y campañas, por campaña y por oráculo, y cuánto queda en tu saldo.

Pasos

1. Gasto de un periodo.

GET /v0/my/funds/ai-usage?from=2026-10-01&to=2026-10-15
→ {"currency": "USDT", "from": "2026-10-01T00:00:00+00:00", "to": "2026-10-15T00:00:00+00:00",
   "charged_usd": 4.12, "requests": 830, "tokens": 9100000,
   "by_campaign": [{"campaign": "<campaign>", "charged_usd": 3.5, "requests": 700, "tokens": 8000000}],
   "by_oracle": [{"oracle": "<oracle>", "charged_usd": 0.62, "requests": 130, "tokens": 1100000}], …}

2. Lo que queda. GET /v0/my/funds/check-balance → {"balance": "31.00", "currency": "USDT", "available": "30.60", …}. available es lo que tus oráculos y campañas aún pueden gastar.

Precio y cobro

• El uso de IA se cobra de tu saldo al precio del proveedor + 18%. charged_usd es ese importe; los cargos aparecen en tus transacciones como AI_USAGE.
• Cuando el saldo se agota, tus oráculos y campañas se pausan hasta que recargas: Pipeline de API: recargar tu saldo con Telegram Stars, TON, USDT en TON o BTC

Reglas

• from / to: RFC 3339 o YYYY-MM-DD (UTC); por defecto desde el inicio del mes hasta ahora. Valores incorrectos → 400.
• campaign: null = IA fuera de tus campañas; oracle: null = IA no ligada a uno de tus oráculos.
• Un token de agenda u oráculo → 404: no tiene gasto propio.

Superficie de la API

Índice: Pipelines de API — índice