# Agweb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.

> Access real-time agricultural news, commodity futures prices for corn and soybeans, and local cash grain bids to stay informed on market trends and pricing. Search articles by category, view detailed market analysis, and get weekend market reports to make informed farming and trading decisions.

**Category:** Finance & Markets | **Website:** [agweb.com/](https://agweb.com/) | **Docs:** [parse.bot/marketplace/256cfa48-41ea-4652-9969-af0784fb774a/agweb-com-api](https://parse.bot/marketplace/256cfa48-41ea-4652-9969-af0784fb774a/agweb-com-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/agweb/`
**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 article detail

Retrieve full content and metadata for a specific article given its URL. Returns the article body text, structured metadata (title, dates, author, description), and tags. Use article URLs obtained from news listing or search endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the AgWeb article (e.g. https://www.agweb.com/news/crops/soybeans/biggest-threat-soybeans-now-are-late-herbicide-passes). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-article-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get cash grain bids

Retrieve location-based cash grain bids for elevators near a specific ZIP code. Returns detailed bid data including commodity names with grain grades, delivery months, basis, cash prices, and elevator location information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US ZIP code, leading zeros preserved (e.g. 61821, 50309). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-cash-grain-bids \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```

### Get corn futures

Convenience endpoint that retrieves detailed futures contract data for Corn (ZC symbol). Equivalent to calling get_futures_data with symbol=ZC.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-corn-futures \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get futures data

Retrieve detailed futures contract data for a specific commodity symbol from Barchart. Returns comprehensive price data, configuration, and contract details across multiple delivery months.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Commodity futures root symbol. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-futures-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get latest markets news

Retrieve the latest news from the Markets section of AgWeb. Returns market-related articles including analysis, USDA reports, and commodity news.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-latest-markets-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get latest news

Retrieve the latest general news articles from AgWeb across all categories. Returns article summaries with titles, URLs, publication dates, and authors. Equivalent to fetching the 'news' category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-latest-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market analysis

Retrieve expert market analysis articles from AgWeb's market-analysis section. Returns daily analyst commentary on grain, livestock, and commodity futures.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-market-analysis \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get markets overview

Retrieve a snapshot of major commodity market prices from Barchart. Returns market data with contract month, price, and change for major agricultural commodities.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-markets-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news by category

Retrieve news articles filtered by a specific agricultural category. Returns paginated article listings with titles, URLs, summaries, dates, and authors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | News category path. |

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

### Get soybean futures

Convenience endpoint that retrieves detailed futures contract data for Soybeans (ZS symbol). Equivalent to calling get_futures_data with symbol=ZS.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-soybean-futures \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get weekend market report

Retrieve the latest Weekend Market Report articles from AgWeb. Returns periodic market commentary covering grain, livestock, and commodity futures outlook.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/get-weekend-market-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search articles

Search AgWeb for articles using a keyword query. Returns matching articles with titles, URLs, and summaries. Summaries may be empty for some results. Results include both recent and archival matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase (e.g. corn, soybean prices, farm bill). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/agweb/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

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