Perguntas frequentes
Tudo o que você precisa saber sobre a GiroRural API.
1. Quais dados a GiroRural oferece?
Cotações do mercado físico (boi gordo, vaca, novilha, soja, milho e café) por praça em todo o Brasil, mercado futuro, Chicago e dólar, com o horário de cada atualizaçã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.