{"uid":"cap_Y6KiODj3rOCx270pPtd-s","slug":"usda-fas-weekly-export-sales-report-esr-fd7422c3","name":"USDA FAS Weekly Export Sales Report (ESR)","description":"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…).","url":"https://api.tradeenergy-api.workers.dev/api/logistics/usda-ag-export-sales?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SUFhBi59eYIhkpvbT6KEr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monitor weekly soybean export demand","prompt":"What does the latest USDA export sales report say about soybeans — give me total US net new sales, weekly exports, and which countries are the biggest buyers this week?"},{"title":"Track Mexico corn purchase commitments","prompt":"Using the USDA FAS export sales data, how much corn has Mexico committed to buy from the US so far in the current marketing year, and what are their outstanding sales?"},{"title":"Analyze next-year wheat forward sales","prompt":"Pull the USDA weekly export sales report for all wheat and show me the next-marketing-year forward sales already on the books — I want to see which countries have placed orders for next year."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:07.371Z","isFirstParty":false,"canonicalSlug":"usda-fas-weekly-export-sales-report-esr-fd7422c3"}