Documentação GiroRural API v2.1
O que é a GiroRural?
A GiroRural é uma API REST completa para o mercado agropecuário brasileiro. Fornecemos dados em tempo real e históricos de commodities físicas (boi gordo, soja, milho), mercado futuro, câmbio e indicadores agrícolas.
Bem-vindo à documentação da GiroRural. Nossa API foi projetada para ser simples, robusta e confiável, permitindo que você integre dados cruciais do mercado agro brasileiro em suas aplicações com o mínimo de esforço.
Este guia vai te mostrar como fazer sua primeira requisição e explorar os endpoints.
Teste Agora - Sem Cadastro!
Para facilitar o desenvolvimento e testes, você pode experimentar nossa API imediatamente selecionando um endpoint abaixo - sem precisar de token para rotas não protegidas:
Catálogo de Endpoints
Navegue e teste as rotas disponíveis na nossa API.
Cotações Físicas
/api/v1/physical/cotacoes🔑 AuthCotações físicas puros (vaca, novilha, boi china, milho, soja)
/api/v1/physical/cotacoes/resumo🔑 AuthDados físicos agrupados por categoria (bovinos, graos)
/api/v1/physical/boi-gordo🔑 AuthPreço médio do Boi Gordo por estado
/api/v1/physical/soja🔑 AuthCotações físicas de Soja por praça
/api/v1/physical/milho🔑 AuthCotações físicas de Milho por praça
/api/v1/commodities/boi-gordo🔑 AuthIndicador do Boi Gordo
Grãos Direto
/api/v1/grains/physical🔑 AuthMercado físico de soja: agregado de todos os estados
/api/v1/grains/physical/all🔑 AuthAtalho para o mercado físico agregado (todos os estados)
/api/v1/grains/physical/{state}🔑 AuthMercado físico de soja detalhado por estado (ex: pr, mt)
Clima e Localização
/api/v1/weather/forecast🔑 AuthPrevisão do tempo (16 dias) por coordenadas
/api/v1/geocode/reverse🔑 AuthGeocodificação reversa (Lat/Lon para Endereço)
Dólar e Câmbio
/api/v1/dollar/current🔑 AuthCotação do Dólar Comercial Spot
Notícias GiroRural
/api/v1/news🔑 AuthLista todas as notícias publicadas
/api/v1/news/{slug}🔑 AuthBusca o conteúdo completo de uma notícia