# USDA FAS Weekly Export Sales Report (ESR)

> USDA FAS Weekly Export Sales Report (ESR) is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns USDA FAS weekly export sales data for a US agricultural commodity, including US totals and per-destination breakdowns of net new sales, weekly exports, outstanding sales, accumulated exports, and total commitments.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/logistics/usda-ag-export-sales?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usda-fas-weekly-export-sales-report-esr-fd7422c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y6KiODj3rOCx270pPtd-s

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability usda-fas-weekly-export-sales-report-esr-fd7422c3
```

Example prompt: Pull the latest USDA weekly export sales report for corn — show me the US totals and the top 20 destination countries with their net new sales, weekly exports, and outstanding sales figures.

## When to prefer this

Use this endpoint when you need official USDA FAS weekly export sales data for specific US agricultural commodities — corn, soybeans, wheat, sorghum, cotton, rice, soybean meal/oil, beef, pork, and more. It's the right choice when you need destination-level granularity (which countries are buying), marketing-year-to-date accumulations, outstanding sales pipelines, or next-year forward commitments, all sourced directly from the authoritative USDA FAS ESR system. Prefer this over generic commodity news sources when precise official trade flow numbers are required.

## Known failure modes

- Missing required 'commodity' query parameter returns an error
- Invalid or unrecognized commodity name/code returns an error
- Requested week not yet released or not a valid Thursday date returns no data or an error
- marketing year outside available history may return empty results
- country filter that doesn't match any destination returns an empty destinations array
- API rate limits or upstream USDA FAS API unavailability may cause timeout or 5xx error

## How this service works

USDA weekly export sales report (FAS ESR) for a US farm commodity — corn, soybeans, wheat classes, sorghum, cotton, rice, soybean meal/oil, beef, pork and more: for one week of the marketing year, US totals and every destination's weekly exports, net new sales, outstanding sales, accumulated exports and total commitments, plus next-year sales; top buyers first. Units as reported (metric tons, running bales…).

## Output

A JSON object containing the commodity name, marketing year, week ending date, release timestamp, unit of measure, US aggregate totals (gross new sales, weekly exports, net new sales, outstanding sales, accumulated exports, next-year outstanding sales, total commitments), and an array of destination country rows sorted by volume — each with the same set of trade flow fields plus country name and code. Also includes metadata like weeks available, marketing year start/end, and data source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "commodity"
     ],
     "properties": {
      "week": {
       "type": "string",
       "description": "Week ending date YYYY-MM-DD (a Thursday). Default: the latest released week"
      },
      "limit": {
       "type": "integer",
       "description": "Max destination rows, 1-200 (default 20)"
      },
      "country": {
       "type": "string",
       "description": "Optional destination filter, e.g. Mexico, Japan"
      },
      "commodity": {
       "type": "string",
       "description": "Commodity name or ESR code, e.g. corn, soybeans, all wheat, sorghum, all upland cotton, pork, 401"
      },
      "marketYear": {
       "type": "integer",
       "description": "Marketing year as USDA numbers it (e.g. 2027 for corn Sep 2026-Aug 2027). Default: the current one"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "Metric Tons",
  "count": 10,
  "source": "USDA FAS Export Sales Reporting (api.fas.usda.gov)",
  "released": "2026-10-22T08:30:42.67",
  "usTotals": {
   "grossNewSales": 1703749,
   "weeklyExports": 780260,
   "nextMYNetSales": 0,
   "outstandingSales": 12648234,
   "currentMYNetSales": 1527122,
   "accumulatedExports": 9544436,
   "nextMYOutstandingSales": 401940,
   "currentMYTotalCommitment": 22192670
  },
  "checkedAt": "2026-10-23T09:38:05.189Z",
  "commodity": "Corn",
  "marketYear": 2027,
  "weekEnding": "2026-10-15",
  "destinations": [
   {
    "country": "MEXICO",
    "countryCode": 2010,
    "grossNewSales": 423397,
    "weeklyExports": 379202,
    "nextMYNetSales": 0,
    "outstandingSales": 5345611,
    "currentMYNetSales": 477713,
    "accumulatedExports": 3358109,
    "nextMYOutstandingSales": 375400,
    "currentMYTotalCommitment": 8703720
   },
   {
    "country": "UNKNOWN",
    "countryCode": 9990,
    "grossNewSales": 405300,
    "weeklyExports": 0,
    "nextMYNetSales": 0,
    "outstandingSales": 2548093,
    "currentMYNetSales": 307214,
    "accumulatedExports": 0,
    "nextMYOutstandingSales": 2540,
    "currentMYTotalCommitment": 2548093
   }
  ],
  "commodityCode": 401,
  "marketYearEnd": "2027-08-31",
  "weeksAvailable": 7,
  "marketYearStart": "2026-09-01",
  "destinationsReporting": 40
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usda-fas-weekly-export-sales-report-esr-fd7422c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)