# Produceiq — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track real-time produce commodity prices across 39 items in fruits, vegetables, melons, and more, with weekly updates and historical pricing data stretching back to 2005. Monitor price trends and build live price feeds to stay informed on market movements across the produce industry.

**Category:** Food & Dining | **Website:** [www.produceiq.com/index](https://www.produceiq.com/index) | **Docs:** [parse.bot/marketplace/c6f6b52f-0cd8-4a19-b5e7-2f487fe085fa/produceiq-com-api](https://parse.bot/marketplace/c6f6b52f-0cd8-4a19-b5e7-2f487fe085fa/produceiq-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/produceiq/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get commodity history

Get historical weekly price data for a specific commodity. Returns the commodity's current price, rate of change, and an array of weekly price records optionally filtered by year. Limit controls how many historical records are returned (most recent first). If the commodity name does not match any known commodity, returns a stale_input error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `commodity` | string | Yes | Commodity name to look up (case-insensitive partial match). Examples: 'avocados', 'strawberries', 'tomatoes', 'limes', 'potatoes'. |
| `limit` | integer | No | Maximum number of weekly price records to return. |
| `year` | string | No | Filter prices to a specific year (e.g. '2025', '2026'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/produceiq/get-commodity-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"commodity":"<string>","limit":"<integer>","year":"<string>"}'
```

### Get current prices

Get the latest prices for all produce commodities. Returns current price per pound, weekly rate of change, and last update timestamp for each commodity. Optionally filter by category or commodity name (both case-insensitive partial match). Returns all 39 commodities when no filters applied.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter by category name (case-insensitive partial match). Accepts full category names or partial strings. |
| `commodity` | string | No | Filter by commodity name (case-insensitive partial match). Examples: 'avocados', 'strawberries', 'potatoes', 'limes'. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/produceiq/get-current-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","commodity":"<string>"}'
```

### Get industry index

Get the overall produce industry price index — a single weighted average price across all commodities, updated weekly. Returns weekly price records optionally filtered by year, plus the list of all available data years (2005 to present). Limit controls how many weekly records are returned (most recent first).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of weekly records to return. |
| `year` | string | No | Filter to a specific year (e.g. '2025', '2026'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/produceiq/get-industry-index \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","year":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.