US Cattle Auction Reports API

Kossin Labs · Normalized USDA AMS cattle auction reports as JSON.

Attribution: Source: USDA AMS Livestock, Poultry & Grain Market News (public). Not affiliated with USDA. Data as published by AMS; we only normalize fields for API use. We do not sell CME, Fastmarkets, Platts, or other proprietary feeds.

Quickstart

curl -s -H "X-API-Key: kl_free_demo_2026" \
  "https://api.kossinlabs.com/v1/latest"

curl -s -H "X-API-Key: kl_free_demo_2026" \
  "https://api.kossinlabs.com/v1/prices?class=STEERS&state=MO&weight_min=500&weight_max=700&limit=10"

Base URL: https://api.kossinlabs.com · OpenAPI: /openapi.json

Auth

Header X-API-Key or query api_key. Demo free key: kl_free_demo_2026.

Pricing

Plan	Price	Daily limit	Notes
Free	$0	100	Demo key above. Self-serve.
Starter	$29/mo	5,000	Subscribe, $29/mo

Subscribe, $29/mo

Your key is emailed within 24 hours. Pro (webhooks / higher limits) comes later.

Endpoints

Method	Path	Auth	Description
GET	`/`	no	This page
GET	`/health`	no	Liveness, counts, freshness
GET	`/openapi.json`	no	OpenAPI 3.0 spec
GET	`/v1/auctions`	yes	`?state=&limit=&offset=`
GET	`/v1/reports`	yes	`?auction=&date=&state=&limit=&offset=`
GET	`/v1/prices`	yes	`?class=&category=&state=&date=&weight_min=&weight_max=&limit=&offset=`
GET	`/v1/latest`	yes	Recent reports + sample feeder lots

Response envelope

Success: { "ok": true, "count": N, "…": …, "attribution": "…" }. Errors: { "ok": false, "error": "code", "message": "…" }.

List endpoints support limit (default 50–100, max 500) and offset.

Field definitions

Field	Meaning
`slug_id`	AMS report slug id (stable auction id)
`report_date`	Sale / report begin date (YYYY-MM-DD)
`category`	FEEDER CATTLE \| SLAUGHTER CATTLE \| REPLACEMENT CATTLE
`class_name`	STEERS, HEIFERS, COWS, BULLS, etc.
`grade`	AMS grade line (e.g. Medium and Large 1)
`unit`	Usually Per Cwt / Actual Wt
`head_count`	Head in that price row
`weight_*`	Weight range and average (lbs)
`price_*`	Price range and average (USD per unit as published)
`pdf_url`	Official AMS PDF for that report

Terms & privacy

USDA AMS data remains public; keep the attribution string on redisplays.
Do not claim USDA endorsement. Data may contain AMS errata; we do not alter prices.
API keys identify usage for rate limits. We store hashed keys and request counts, not browsing history.
No sale of personal data. Contact: kossinlabs@gmail.com