Quickstart

This walkthrough takes you from no key to a year of daily butter prices. Every step is one request.

Create an API key

Sign in to the Orbbit console and open API Keys. Click New Key, give it a Name, and under Scope tick the endpoints it may call. For this walkthrough, tick Search Commodities and Get Commodity Prices, then click Create.The console shows the full key once. Copy it now — it starts with orbbit_data_. See Authentication for how keys and their permissions work.

Find a series

Ask the catalog which butter series exist. The commodity filter matches any part of the commodity name or the series ID, ignoring case.

curl --request GET \
  --url 'https://api.orbbit.co/v1/commodities?commodity=butter' \
  --header 'authorization: Bearer YOUR_API_KEY'

Each series in the response has a slug — its ID. Pick butter-cme-spot-close-daily, the daily closing price on the CME spot market.

{
  "data": [
    {
      "commodity": "Butter",
      "series": [
        {
          "slug": "butter-cme-spot-close-daily",
          "spec": "Grade AA",
          "market": "CME spot call, Chicago",
          "measure": "close_price",
          "unit": "USD/lb",
          "frequency": "daily",
          "source": "usda-mars",
          "report": "CME Group Daily Cash Trading",
          "first_observed_on": "2019-01-02",
          "last_observed_on": "2026-09-22"
        }
      ]
    }
  ]
}

Pull the prices

Pass the slug to the prices endpoint with a date range. Both dates are included.

curl --request GET \
  --url 'https://api.orbbit.co/v1/commodities/prices?series=butter-cme-spot-close-daily&from=2025-09-01&to=2026-08-31' \
  --header 'authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "slug": "butter-cme-spot-close-daily",
      "unit": "USD/lb",
      "points": [
        { "date": "2025-09-02", "value": 2.1875 },
        { "date": "2025-09-03", "value": 2.195 }
      ]
    }
  ]
}

Response trimmed for clarity. Each point is one trading day, in date order.

What to do next

Compare several series at once — pass up to 100 slugs, comma-separated, to Get commodity prices.
Look up a packaged food — see Search branded foods.
Browse D2C brands — see Search stores; add industry=cpg for consumer packaged goods brands.
Handle errors — see Errors for every error your code should expect.
Let your AI assistant do it — see AI agents.

Getting Started

AI Agents

Market Data

Industry Data

What to do next

​What to do next

What to do next