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

# Introduction

> Orbbit Data API: commodity prices and packaged-food data.

Orbbit's Data API answers two kinds of questions about a business: what its inputs cost, and what it makes and sells. It's one read-only REST API. Every endpoint takes an `Authorization: Bearer <key>` header, answers in JSON, and starts with `/v1`.

## How the data is organized

> [card] [Market data](https://data-docs.orbbit.co/market-data/commodities.md)
>
> Prices that apply to any industry. Today: Commodities, dairy and chicken prices published by the USDA, from daily to annual.

> [card] [Industry data](https://data-docs.orbbit.co/industry-data/cpg/overview.md)
>
> Data about the companies and products inside one industry. Today: CPG (consumer packaged goods).

Industry data is grouped by industry first, then by kind of data:

| Industry | Data set | What it tells you |
| - | - | - |
| CPG | [Branded food](https://data-docs.orbbit.co/industry-data/cpg/branded-food.md) | What's in a packaged food: ingredients, nutrition, serving, barcode, maker. |

## First call

List every commodity Orbbit has prices for. This call is free:

```bash theme={null}
curl --request GET \
  --url https://data-api.orbbit.co/v1/commodities \
  --header 'authorization: Bearer YOUR_API_KEY'
```

Continue with the [Quickstart](https://data-docs.orbbit.co/quickstart.md), or open the **API Reference** tab to try any endpoint in the browser.

## What lives where

| If you want to… | Go to |
| - | - |
| Make your first call | [Quickstart](https://data-docs.orbbit.co/quickstart.md) |
| Get and use an API key | [Authentication](https://data-docs.orbbit.co/authentication.md) |
| Understand an error | [Errors](https://data-docs.orbbit.co/errors.md) |
| Know what a call costs | [Pricing & Billing](https://data-docs.orbbit.co/pricing.md) |
| Work through an AI assistant | [For Agents](https://data-docs.orbbit.co/for-agents/llms-txt.md) |
| Look up an exact parameter or field | The **API Reference** tab |

## Where the data comes from

Every record carries a `source` field that names where it came from.

| `source` | Publisher | Data set |
| - | - | - |
| `usda-mars` | USDA Market News (dairy and chicken prices, including CME spot) | Commodities |
| `usda-mpr` | USDA Mandatory Price Reporting (dairy sales and milk prices) | Commodities |
| `usda-fdc` | USDA FoodData Central, branded foods dataset | Branded food |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.