> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbbit.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get an API key and pull your first commodity prices in under five minutes.

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

<Steps>
  <Step title="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](/authentication) for how keys and their permissions work.
  </Step>

  <Step title="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.

    ```bash theme={null}
    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.

    ```json theme={null}
    {
      "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"
            }
          ]
        }
      ]
    }
    ```
  </Step>

  <Step title="Pull the prices">
    Pass the slug to the prices endpoint with a date range. Both dates are included.

    ```bash theme={null}
    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'
    ```

    ```json theme={null}
    {
      "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.
  </Step>
</Steps>

## What to do next

* **Compare several series at once** — pass up to 100 slugs, comma-separated, to [Get commodity prices](/api-reference/commodities/get-commodity-prices).
* **Look up a packaged food** — see [Search branded foods](/api-reference/branded-food/search-branded-foods).
* **Browse D2C brands** — see [Search stores](/api-reference/shopify/search-stores); add `industry=cpg` for consumer packaged goods brands.
* **Handle errors** — see [Errors](/errors) for every error your code should expect.
* **Let your AI assistant do it** — see [AI agents](/ai-agents).