{
"data": [
{
"commodity": "crude_oil",
"group": "energy",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"coverage": "countries with available stocks + US hubs",
"status": "live",
"last_updated": "2026-08-21"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14043/crude+oil+inventory+fetcher+api/34153/list+commodities?group=energy&status=live' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"group": "energy",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"history_from": "1982-08-20",
"last_updated": "2026-08-21",
"coverage": "countries with available stocks + US hubs",
"areas_count": {
"countries": 35,
"hubs": 7
}
}
curl --location --request GET 'https://zylalabs.com/api/14043/crude+oil+inventory+fetcher+api/34154/get+commodity&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"data": [
{
"area": "AT",
"name": "Austria",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "AU",
"name": "Australia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "BE",
"name": "Belgium",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CA",
"name": "Canada",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CH",
"name": "Switzerland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CL",
"name": "Chile",
"type": "country",
"latest": "2026-05-01"
},
{
"area": "CZ",
"name": "Czech Republic",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "DE",
"name": "Germany",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "DK",
"name": "Denmark",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "EE",
"name": "Estonia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "ES",
"name": "Spain",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "FI",
"name": "Finland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "FR",
"name": "France",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "GB",
"name": "United Kingdom",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "GR",
"name": "Greece",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "HU",
"name": "Hungary",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IE",
"name": "Ireland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IS",
"name": "Iceland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IT",
"name": "Italy",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "JP",
"name": "Japan",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "KR",
"name": "South Korea",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LT",
"name": "Lithuania",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LU",
"name": "Luxembourg",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LV",
"name": "Latvia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "MX",
"name": "Mexico",
"type": "country",
"latest": "2025-02-01"
},
{
"area": "NL",
"name": "Netherlands",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "NO",
"name": "Norway",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "NZ",
"name": "New Zealand",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "PL",
"name": "Poland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "PT",
"name": "Portugal",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SE",
"name": "Sweden",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SI",
"name": "Slovenia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SK",
"name": "Slovakia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "TR",
"name": "Turkey",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "US",
"name": "United States",
"type": "country",
"latest": "2026-08-21"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14043/crude+oil+inventory+fetcher+api/34156/list+commodity+areas?type=country&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US-SPR",
"name": "Strategic Petroleum Reserve",
"period": "2026-08-21",
"value": 289726,
"reliability": "reported"
},
{
"area": "US-PADD3",
"name": "PADD 3 - Gulf Coast",
"period": "2026-08-21",
"value": 251424,
"reliability": "reported"
},
{
"area": "US-PADD2",
"name": "PADD 2 - Midwest",
"period": "2026-08-21",
"value": 101195,
"reliability": "reported"
},
{
"area": "US-PADD5",
"name": "PADD 5 - West Coast",
"period": "2026-08-21",
"value": 45343,
"reliability": "reported"
},
{
"area": "US-PADD4",
"name": "PADD 4 - Rocky Mountain",
"period": "2026-08-21",
"value": 22524,
"reliability": "reported"
},
{
"area": "US-CUSHING",
"name": "Cushing, OK",
"period": "2026-08-21",
"value": 22428,
"reliability": "reported"
},
{
"area": "US-PADD1",
"name": "PADD 1 - East Coast",
"period": "2026-08-21",
"value": 8423,
"reliability": "reported"
}
],
"meta": {
"count": 7,
"period_min": "2026-08-21",
"period_max": "2026-08-21"
}
}
curl --location --request GET 'https://zylalabs.com/api/14043/crude+oil+inventory+fetcher+api/34157/latest+inventory?type=hub&sort=value_desc&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US",
"period": "2026-08-21",
"value": 428910,
"reliability": "reported"
},
{
"area": "US-CUSHING",
"period": "2026-08-21",
"value": 22428,
"reliability": "reported"
}
],
"meta": {
"count": 2,
"next_cursor": "MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy",
"from": "2026-08-01",
"to": "2026-08-21",
"from_defaulted": false
}
}
curl --location --request GET 'https://zylalabs.com/api/14043/crude+oil+inventory+fetcher+api/34158/inventory+time+series?area=US,US-CUSHING&from=2026-08-01&to=2026-08-21&limit=2&cursor=MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US",
"period": "2026-08-21",
"value": 428910,
"change": 95,
"change_pct": 0.02
},
{
"area": "US-CUSHING",
"period": "2026-08-21",
"value": 22428,
"change": 1176,
"change_pct": 5.53
},
{
"area": "US",
"period": "2026-08-14",
"value": 428815,
"change": 4405,
"change_pct": 1.04
},
{
"area": "US-CUSHING",
"period": "2026-08-14",
"value": 21252,
"change": -1314,
"change_pct": -5.82
},
{
"area": "US",
"period": "2026-08-07",
"value": 424410,
"change": 17423,
"change_pct": 4.28
},
{
"area": "US-CUSHING",
"period": "2026-08-07",
"value": 22566,
"change": 1611,
"change_pct": 7.69
},
{
"area": "US",
"period": "2026-07-31",
"value": 406987,
"change": 2479,
"change_pct": 0.61
},
{
"area": "US-CUSHING",
"period": "2026-07-31",
"value": 20955,
"change": 2356,
"change_pct": 12.67
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14043/crude+oil+inventory+fetcher+api/34159/inventory+changes?area=US,US-CUSHING&periods=4&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Obtenedor de Inventário de Petróleo Bruto API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
A API de Obtenção de Inventário de Petróleo Bruto retorna os estoques de fechamento de petróleo bruto por país e por hub de armazenamento dos Estados Unidos. Os valores estão em milhares de barris. A cobertura inclui países que relatam estoques e hubs como Cushing, Oklahoma, a Reserva Estratégica de Petróleo e as cinco regiões PADD. O código de commodity ao vivo é crude_oil. Use List Commodities para ler o catálogo, Get Commodity para o perfil e o início da história, List Commodity Areas para códigos de país e hub, Latest Inventory para o nível atual de cada área, Inventory Time Series para histórico e Inventory Changes para a mudança em relação ao período anterior. Filtre uma série ou uma mudança com códigos de área como US, JP ou US-CUSHING. Trigo, milho, gás natural, lítio e cobre estão listados como planejados, e as chamadas de inventário para esses códigos retornam indisponíveis até que fiquem ao vivo.
Mil barris Inventário de respostas inclui unidade definida para mil_barris Obter Mercadoria retorna a mesma unidade no perfil da mercadoria
Fechamento de estoques de petróleo bruto por país e por centro dos Estados Unidos em mil barris. Cada linha contém a área o período e o nível de estoque. Mudanças de inventário também retorna a variação em relação ao período anterior e a variação percentual
Países que reportam estoques, além dos centros dos Estados Unidos. Os centros incluem Cushing, Oklahoma, o Reserva Estratégica de Petróleo e as regiões PADD 1 a 5. Os códigos de área são como US, JP e US-CUSHING
Passar a commodity crude_oil e a área US-CUSHING para Últimos Estoques, Série Temporal de Estoques ou Mudanças de Estoques. US-CUSHING é o código do hub para Cushing, Oklahoma
Obtenha o histórico de retornos de commodities de. Para o petróleo cru essa data é 20-08-1982 na série dos Estados Unidos Outros países começam no primeiro período que existir para essa área Defina a partir em Série Temporal de Inventário para escolher a data de início
O_petróleo_crude está ao vivo O trigo o milho o gás natural o lítio e o cobre estão no catálogocom status planejado Uma chamada de inventário para um código planejado retorna não disponível até que essa mercadoria entre ao vivo
Cada ponto de extremidade retorna dados específicos de inventário de petróleo bruto Por exemplo o Inventário Mais Recente fornece níveis de estoque atuais a Série Temporal de Inventário oferece dados históricos e as Mudanças de Inventário mostram variações de estoque ao longo de períodos Cada resposta inclui métricas relevantes como área período e valor em milhares de barris
Os campos principais incluem "área" (código do local), "nome" (nome do local), "período" (data dos dados), "valor" (nível de estoque em mil barris), "mudança" (mudança de estoque) e "confiabilidade" (confiabilidade da fonte de dados). Esses campos ajudam os usuários a entender o status e as tendências do inventário
Os dados de resposta estão estruturados no formato JSON, com um objeto principal contendo arrays de "commodity" e "data". Cada entrada de "data" inclui campos relevantes como área, nome e valores de estoque. Esta organização permite uma fácil análise e interpretação das informações de inventário
Os parâmetros variam de acordo com o endpoint. Por exemplo, o Último Inventário aceita códigos de área (por exemplo, US-CUSHING) para especificar locais. A Série Temporal de Inventário permite que os usuários definam intervalos de datas com os parâmetros "de" e "para". Os usuários podem personalizar solicitações com base em suas necessidades de dados
Cada ponto final fornece informações distintas: Listar Commodities mostra as commodities disponíveis Obter Commodity detalha o perfil do petróleo bruto Listar Áreas de Commodities enumera países e centros Último Inventário fornece os níveis de estoque atuais Série Temporal de Inventário oferece dados históricos e Mudanças no Inventário mostra variações de estoque
A precisão dos dados é mantida por meio de atualizações regulares de fontes confiáveis, incluindo relatórios governamentais e publicações do setor. Cada resposta inclui um campo de "confiabilidade" indicando a credibilidade da fonte, garantindo que os usuários possam avaliar a qualidade dos dados fornecidos
Os casos de uso típicos incluem análise de mercado decisões de investimento e gestão da cadeia de suprimentos Analistas usam os dados para rastrear tendências de inventário prever movimentos de mercado e avaliar o impacto das mudanças de inventário nos preços do petróleo bruto
Os usuários podem analisar os dados para identificar tendências, comparar níveis de estoque entre regiões e avaliar mudanças ao longo do tempo. Ao aproveitar os campos "change" e "change_pct", os usuários podem avaliar a importância das flutuações de estoque e tomar decisões informadas com base nas condições de mercado