---
title: "Batch price lookup"
method: POST
path: "/v1/prices/batch"
tags: ["Prices"]
---

# Batch price lookup

`POST /v1/prices/batch`

Get latest prices for multiple commodities in a single request.
Accepts up to 50 commodity codes. Counts as 1 request against your monthly quota.
Supports shorthand aliases (e.g., 'BRENT' → 'BRENT_CRUDE_USD') and case-insensitive codes.

## Request body

- object
  - `codes` string[], required

## Response `200`

Batch price data

- object
  - `status` string
  - `data` object
    - `prices` object[]
      - `code` string
      - `price` number — Actual price in commodity's currency (not cents)
      - `formatted` string
      - `currency` string
      - `unit` string
      - `updated_at` string, date-time
      - `source` string
    - `meta` object
      - `requested` integer
      - `returned` integer
      - `missing` string[], nullable
      - `timestamp` string, date-time
      - `request_id` string

## Other responses

- `400` — Invalid request (bad JSON, invalid codes, too many codes)
- `401` — Unauthorized — missing or invalid API key
- `429` — Rate limit exceeded
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/revisions/5a5ce424cacc/schema)