{"ok":true,"api":"AIDeep API v1","version":"1.0.0","openapi":"https://www.aideepeconomics.com/api/openapi.json","docs":"https://www.aideepeconomics.com/api/docs","auth":{"methods":["X-Api-Key","Authorization: Bearer"],"scopes":["series","nowcast","twin","fundamentals","trade","markets","esr"]},"endpoints":[{"method":"GET","path":"/api/v1/series","scope":"series","operationId":"listSeries","params":{"commodity":"opcional: carne|granos|lacteos|fertilizantes|energia|macro|otros"},"description":"Series del observatorio con genealogía de fuentes."},{"method":"GET","path":"/api/v1/series/:id","scope":"series","operationId":"getSeriesById","description":"Una serie por id."},{"method":"GET","path":"/api/v1/nowcast","scope":"nowcast","operationId":"getNowcast","description":"Pronósticos 1-3 meses con backtest walk-forward (MAE vs naive, hit-rate, skill)."},{"method":"POST","path":"/api/v1/twin/simulate","scope":"twin","operationId":"simulateTwinShock","body":{"shocks":[{"nodeId":"brent","pct":20}]},"description":"Propagación de shocks por el grafo causal (β, R² y confianza expuestos)."},{"method":"GET","path":"/api/v1/twin/graph","scope":"twin","operationId":"getTwinGraph","description":"Grafo causal con sensibilidades estimadas."},{"method":"GET","path":"/api/v1/fundamentals/:slug","scope":"fundamentals","operationId":"getFundamentals","params":{"metric":"production|consumption|exports|imports|stocks"},"description":"Oferta/demanda/stocks por país (USDA PSD + FAOSTAT): ranking, share, YoY, stock-to-use."},{"method":"GET","path":"/api/v1/trade/:slug","scope":"trade","operationId":"getTrade","params":{"flow":"exports|imports"},"description":"Flujos bilaterales (UN Comtrade): rutas top con geo, concentración HHI y señales YoY."},{"method":"GET","path":"/api/v1/markets","scope":"markets","operationId":"getMarketsBoard","description":"Board de 13 futuros CBOT/ICE/CME (últ. cierre, Δ1d/30d/1a, vol 30d) + basis Cono Sur (pizarra UY vs CBOT, USD/ton)."},{"method":"GET","path":"/api/v1/markets/series/:symbol","scope":"markets","operationId":"getMarketSeries","description":"Serie diaria completa de un futuro (ej. ZS=F, ZC=F, LE=F)."},{"method":"GET","path":"/api/v1/esr/:slug","scope":"esr","operationId":"getEsr","description":"Ventas semanales de exportación de EE.UU. (USDA ESR): headline, serie semanal y top compradores del año comercial."}],"plans":[{"id":"free","label":"Free","scopes":["series","markets"],"rateLimitPerHour":300,"priceHint":"Gratis · atribución obligatoria","blurb":"Series del observatorio y board de futuros. Ideal para prototipos y uso académico."},{"id":"pro","label":"Pro","scopes":["series","markets","nowcast","fundamentals","trade","esr"],"rateLimitPerHour":2000,"priceHint":"USD 100/mes","blurb":"Todo Free + pronósticos con backtest, fundamentals USDA/FAOSTAT, flujos Comtrade y ventas de exportación US (ESR)."},{"id":"enterprise","label":"Enterprise","scopes":["series","nowcast","twin","fundamentals","trade","markets","esr"],"rateLimitPerHour":20000,"priceHint":"A medida · SLA","blurb":"Todo Pro + simulador causal AgroTwin, rate limit alto, SLA y datos propietarios (AgriShield). Integración a medida."}],"x402":{"enabled":true,"protocol":"x402/1 (https://x402.org)","network":"base-sepolia","asset":"USDC","pricingUsdPerRequest":{"series":0.001,"markets":0.001,"fundamentals":0.005,"trade":0.005,"esr":0.005,"nowcast":0.01,"twin":0.05},"howTo":"Sin API key: GET al endpoint → 402 con `accepts` → pagá y reintentá con el header X-PAYMENT (clientes: @x402/fetch o compatible)."},"attribution":"Fuentes: AgriShield (AIDeep), World Bank Pink Sheet (CC BY 4.0), FAO, IMF PCPS, FRED, INDEC/BCRA vía datos.gob.ar, MAGyP, Cámara Mercantil. Redistribución sujeta a las licencias de cada fuente."}