Quickstart

This walkthrough takes you from signing up to your first cheddar prices. Every step after the first is one request.

Copy your API key

Sign up in the Orbbit console. Your account comes with a key named Default, which can call every endpoint, plus $5 of starting balance to spend.Open API Keys, find Default, click Reveal Secret, and copy the key. It starts with orbbit_data_. See Authentication for how keys, their permissions, and their spend limits work.

Find a price series

List the daily cheddar series in Chicago with List Commodities, which is free. category and commodity pick what is priced, and the other filters narrow by attribute, market and how often the price is published.

curl --globoff --request GET \
  --url 'https://data-api.orbbit.co/v1/commodities?category=dairy&commodity=cheese&attributes[cheese_style]=cheddar&region=us_chicago&frequency=daily&limit=1' \
  --header 'authorization: Bearer YOUR_API_KEY'

Each result is one price series. Its metric_name is its readable ID, and every part of the name is also its own field.

{
  "data": [
    {
      "id": "data_commodity_metric_01m5jbewxffcs9j3neja9k8s4a",
      "metric_name": "cheese_block_cheddar_40_lb_us_chicago_wholesale_daily_close_price_usd_per_lb",
      "product": {
        "category": "dairy",
        "commodity": "cheese",
        "attributes": { "size": "40 lb", "cheese_form": "block", "cheese_style": "cheddar" }
      },
      "region": "us_chicago",
      "market_level": "wholesale",
      "freight": "not_stated",
      "frequency": "daily",
      "price_type": "close",
      "unit": "usd_per_lb",
      "measure": "close_price",
      "source": "usda-mars",
      "first_observed_on": "2021-02-24",
      "last_observed_on": "2026-10-20"
    }
  ],
  "next_cursor": "cheese_block_cheddar_40_lb_us_chicago_wholesale_daily_close_price_usd_per_lb"
}

Pull the values

Pass the metric_name to Get Commodity Metric Values with a date range. Both dates are included. Leave the dates out to get the series’ last year instead.

curl --request GET \
  --url 'https://data-api.orbbit.co/v1/commodities/metric-values?metric_names=cheese_block_cheddar_40_lb_us_chicago_wholesale_daily_close_price_usd_per_lb&start_date=2026-10-16&end_date=2026-10-20' \
  --header 'authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "data_commodity_metric_01m5jbewxffcs9j3neja9k8s4a",
      "metric_name": "cheese_block_cheddar_40_lb_us_chicago_wholesale_daily_close_price_usd_per_lb",
      "unit": "usd_per_lb",
      "start_date": "2026-10-16",
      "end_date": "2026-10-20",
      "values": [
        { "date": "2026-10-16", "value": 1.6825 },
        { "date": "2026-10-19", "value": 1.73 },
        { "date": "2026-10-20", "value": 1.8 }
      ]
    }
  ]
}

Response trimmed: each series also repeats the fields from the list. Each value is one trading day, in date order. start_date and end_date show the dates that were used. Listing series was free and this call cost 1¢. See Pricing & Billing.

What to do next

Compare several series at once: pass up to 100 metric names, comma-separated, to Get Commodity Metric Values.
Understand the default date range: see Commodities.
Look up a packaged food: see Search Branded Foods.
Handle errors: see Errors for every error your code should expect.
Let your AI assistant do it: see Use With Claude.

Getting Started

For Agents

Market Data

Industry Data

What to do next

​What to do next

What to do next