Perguntas Frequentes (FAQ)
Tudo o que você precisa saber sobre a GiroRural API.
1. De onde vêm os dados da GiroRural?
Nossos dados são extraídos de fontes oficiais consolidadas do mercado agropecuário brasileiro, incluindo CEPEA/ESALQ, B3 (Bolsa de Valores), Banco Central do Brasil (PTAX) e importantes balcões físicos em todos os estados da federação.
2. Com qual frequência os preços são atualizados?
Os preços do mercado físico (Boi Gordo, Milho, Soja, etc) são consolidados diariamente, geralmente às 17h, refletindo o fechamento do mercado daquele dia. Já o mercado futuro da B3 recebe atualizações intra-day (vários snapshots durante o dia, a depender do plano/endpoint).
3. O que acontece se eu ultrapassar meu limite de requisições?
Se você exceder a quota do seu plano atual (ex: 10.000 requisições/mês), os novos pedidos à API retornarão um código HTTP 429 (Too Many Requests). Aconselhamos assinar um plano superior ou implementar estratégias de cache (Redis, memcached) do seu lado para economizar requisições.
4. Como acesso o Histórico (OHLC)?
Dados históricos complexos estão vinculados ao plano Profissional e Enterprise. Nestes planos, a rota dedicada /api/v1/history/commodity/{symbol} retorna arrays inteiros contendo (Data, Open, High, Low, Close) retroativos a até 5 anos, ideais para criação de gráficos tipo Candlestick ou para Backtests de Trading Agrícola.
5. É garantido que os dados nunca falhem?
A GiroRural mantém um Uptime mensal de 99.9%. Embora dados contem com backups triplos e caching superveloz com Redis globalmente, existem janelas programadas raríssimas de manutenção nos finais de semana que avisamos via email e no próprio Dashboard aos assinantes.