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. Nossos dados são obtidos de fontes oficiais: CEPEA (cotações físicas), B3 / CME (mercado futuro) e Banco Central do Brasil (dólar).

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:

Selecione um endpoint acima para ver o exemplo de uso integrado.

Catálogo de Endpoints

Navegue e teste as rotas disponíveis na nossa API.

Cotações Físicas

GET/api/v1/physical/cotacoes🔑 Auth

Cotações físicas puros (vaca, novilha, boi china, milho, soja)

GET/api/v1/physical/cotacoes/resumo🔑 Auth

Dados físicos agrupados por categoria (bovinos, graos)

GET/api/v1/physical/boi-gordo🔑 Auth

Preço médio do Boi Gordo por estado (Datagro)

GET/api/v1/physical/soja🔑 Auth

Cotações físicas de Soja por praça

GET/api/v1/physical/milho🔑 Auth

Cotações físicas de Milho por praça

GET/api/v1/commodities/boi-gordo🔑 Auth

Indicador Boi Gordo Datagro

Grãos Direto

GET/api/v1/grains/physical🔑 Auth

Mercado físico de soja: agregado de todos os estados

GET/api/v1/grains/physical/all🔑 Auth

Atalho para o mercado físico agregado (todos os estados)

GET/api/v1/grains/physical/{state}🔑 Auth

Mercado físico de soja detalhado por estado (ex: pr, mt)

Clima e Localização

GET/api/v1/weather/forecast🔑 Auth

Previsão do tempo (16 dias) por coordenadas

GET/api/v1/geocode/reverse🔑 Auth

Geocodificação reversa (Lat/Lon para Endereço)

Dólar e Câmbio

GET/api/v1/dollar/current🔑 Auth

Cotação do Dólar Comercial Spot

Notícias GiroRural

GET/api/v1/news🔑 Auth

Lista todas as notícias publicadas

GET/api/v1/news/{slug}🔑 Auth

Busca o conteúdo completo de uma notícia