{ "openapi": "3.1.0", "info": { "title": "Anymal OS World cattle-market answer API", "version": "1.0.0", "description": "Anymal OS World organizes USDA AMS auction prices, sale-barn directory and schedule context, county and state price aggregates, drought, weather, diesel, and futures signals into action-ready cattle-market intelligence. This contract describes read-only cattle-market answer endpoints only. It excludes write, lead-ingest, admin, map-rendering, tile, and app-plumbing endpoints. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest." }, "servers": [ { "url": "https://anymal-os-public-feeds-production.up.railway.app", "description": "Key-required public-feeds production base consumed by Anymal OS World; not an unauthenticated public proxy." } ], "tags": [ { "name": "Cattle market answers", "description": "Read-only price, directory, and market-context answer data." } ], "paths": { "/price-by-county": { "get": { "operationId": "priceByCounty", "summary": "Get source-backed county cattle price aggregates.", "description": "Get source-backed county cattle price aggregates. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest. Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "tags": [ "Cattle market answers" ], "security": [ { "AnymalPublicFeedsApiKey": [] } ], "parameters": [ { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional ZIP code used by the app for nearest county and barn context." }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional two-letter state filter where supported." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional row limit where supported." } ], "responses": { "200": { "description": "Read-only cattle-market answer data.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": { "generated_at": { "type": [ "string", "null" ] }, "source_date": { "type": [ "string", "null" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } } } } } } }, "403": { "description": "Public-feeds may require deployment-provided API access. The static contract does not expose credentials." } }, "x-source-registry": [ "usda-ams-lmr-datamart", "usda-mars", "anymal-derived-aggregates" ], "x-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ], "x-citation-boundaries": [ { "id": "usda-ams-lmr-datamart", "boundary": "A reported auction-price signal for the report date and venue, not a guaranteed current transaction price or promise of future bid." }, { "id": "usda-mars", "boundary": "A reported market-news signal for a report window, not a guaranteed real-time bid or packer commitment." }, { "id": "anymal-derived-aggregates", "boundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." } ] } }, "/price-by-state": { "get": { "operationId": "priceByState", "summary": "Get state-level cattle price aggregates when exposed by public-feeds.", "description": "Get state-level cattle price aggregates when exposed by public-feeds. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest. Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "tags": [ "Cattle market answers" ], "security": [ { "AnymalPublicFeedsApiKey": [] } ], "parameters": [ { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional two-letter state filter where supported." } ], "responses": { "200": { "description": "Read-only cattle-market answer data.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": { "generated_at": { "type": [ "string", "null" ] }, "source_date": { "type": [ "string", "null" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } } } } } } }, "403": { "description": "Public-feeds may require deployment-provided API access. The static contract does not expose credentials." } }, "x-source-registry": [ "usda-ams-lmr-datamart", "usda-mars", "anymal-derived-aggregates" ], "x-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ], "x-citation-boundaries": [ { "id": "usda-ams-lmr-datamart", "boundary": "A reported auction-price signal for the report date and venue, not a guaranteed current transaction price or promise of future bid." }, { "id": "usda-mars", "boundary": "A reported market-news signal for a report window, not a guaranteed real-time bid or packer commitment." }, { "id": "anymal-derived-aggregates", "boundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." } ] } }, "/latest-prices": { "get": { "operationId": "latestPrices", "summary": "Get latest cattle price records used by the live price and market surfaces.", "description": "Get latest cattle price records used by the live price and market surfaces. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest. Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "tags": [ "Cattle market answers" ], "security": [ { "AnymalPublicFeedsApiKey": [] } ], "parameters": [ { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional latitude used by local price workflows." }, { "name": "lon", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional longitude used by local price workflows." } ], "responses": { "200": { "description": "Read-only cattle-market answer data.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": { "generated_at": { "type": [ "string", "null" ] }, "source_date": { "type": [ "string", "null" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } } } } } } }, "403": { "description": "Public-feeds may require deployment-provided API access. The static contract does not expose credentials." } }, "x-source-registry": [ "usda-ams-lmr-datamart", "usda-mars", "anymal-derived-aggregates" ], "x-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ], "x-citation-boundaries": [ { "id": "usda-ams-lmr-datamart", "boundary": "A reported auction-price signal for the report date and venue, not a guaranteed current transaction price or promise of future bid." }, { "id": "usda-mars", "boundary": "A reported market-news signal for a report window, not a guaranteed real-time bid or packer commitment." }, { "id": "anymal-derived-aggregates", "boundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." } ] } }, "/cattle-sale-barn-directory": { "get": { "operationId": "cattleSaleBarnDirectory", "summary": "Get the source-backed cattle sale-barn directory export.", "description": "Get the source-backed cattle sale-barn directory export. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest. Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "tags": [ "Cattle market answers" ], "security": [ { "AnymalPublicFeedsApiKey": [] } ], "parameters": [ { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional two-letter state filter where supported." } ], "responses": { "200": { "description": "Read-only cattle-market answer data.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": { "generated_at": { "type": [ "string", "null" ] }, "source_date": { "type": [ "string", "null" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } } } } } } }, "403": { "description": "Public-feeds may require deployment-provided API access. The static contract does not expose credentials." } }, "x-source-registry": [ "usda-ams-lmr-datamart", "anymal-derived-aggregates" ], "x-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ], "x-citation-boundaries": [ { "id": "usda-ams-lmr-datamart", "boundary": "A reported auction-price signal for the report date and venue, not a guaranteed current transaction price or promise of future bid." }, { "id": "anymal-derived-aggregates", "boundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." } ] } }, "/barns": { "get": { "operationId": "barns", "summary": "Get cattle sale-barn records consumed by the map, registry, and directory surfaces.", "description": "Get cattle sale-barn records consumed by the map, registry, and directory surfaces. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest. Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "tags": [ "Cattle market answers" ], "security": [ { "AnymalPublicFeedsApiKey": [] } ], "parameters": [ { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional two-letter state filter." }, { "name": "county", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional county filter." }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional status filter." } ], "responses": { "200": { "description": "Read-only cattle-market answer data.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": { "generated_at": { "type": [ "string", "null" ] }, "source_date": { "type": [ "string", "null" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } } } } } } }, "403": { "description": "Public-feeds may require deployment-provided API access. The static contract does not expose credentials." } }, "x-source-registry": [ "usda-ams-lmr-datamart", "openstreetmap-parcel-context", "anymal-derived-aggregates" ], "x-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ], "x-citation-boundaries": [ { "id": "usda-ams-lmr-datamart", "boundary": "A reported auction-price signal for the report date and venue, not a guaranteed current transaction price or promise of future bid." }, { "id": "openstreetmap-parcel-context", "boundary": "A location anchor, not title work, ownership certification, survey, or official parcel determination." }, { "id": "anymal-derived-aggregates", "boundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." } ] } }, "/dealers/stats": { "get": { "operationId": "dealersStats", "summary": "Get licensed dealer statistics used as market and operator context.", "description": "Get licensed dealer statistics used as market and operator context. Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest. Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "tags": [ "Cattle market answers" ], "security": [ { "AnymalPublicFeedsApiKey": [] } ], "parameters": [], "responses": { "200": { "description": "Read-only cattle-market answer data.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": { "generated_at": { "type": [ "string", "null" ] }, "source_date": { "type": [ "string", "null" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "limitations": { "type": "array", "items": { "type": "string" } } } } } } }, "403": { "description": "Public-feeds may require deployment-provided API access. The static contract does not expose credentials." } }, "x-source-registry": [ "state-agriculture-reference-pages", "anymal-derived-aggregates" ], "x-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ], "x-citation-boundaries": [ { "id": "state-agriculture-reference-pages", "boundary": "A reference to agency-published material, not a guarantee that a user-specific sale, movement, or document is compliant." }, { "id": "anymal-derived-aggregates", "boundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." } ] } } }, "components": { "securitySchemes": { "AnymalPublicFeedsApiKey": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "API key required for direct public-feeds calls. Keys are deployment credentials and are not publicly issued in this static machine contract." } }, "schemas": { "EvidenceField": { "type": "string", "enum": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ] }, "SourceRegistryEntry": { "type": "object", "required": [ "id", "name", "type", "role", "citationBoundary" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "role": { "type": "string" }, "citationBoundary": { "type": "string" } } } } }, "x-trust-boundary": "Anymal OS World is a cattle-market intelligence and operational source. It is not a futures broker, financial advisor, veterinarian, regulatory agency, or guarantor of current transaction price, sale schedule, animal health status, or legal compliance.", "x-openapi-access-reality": { "mode": "api_key_required", "unauthenticatedPublicProxyVerified": false, "publicAgentAccess": "canonical_pages_and_llms_full", "securitySchemeName": "AnymalPublicFeedsApiKey", "apiKeyHeader": "X-API-Key", "description": "Direct calls to the public-feeds endpoints require an API key that is not publicly issued. Public agent access is via the canonical pages, static HTML, llms.txt, llms-full.txt, the source registry, and the machine manifest." }, "x-source-registry": [ { "id": "usda-ams-lmr-datamart", "name": "USDA AMS Livestock, Poultry, and Grain Market News / LMR Datamart", "type": "public-market-report", "role": "Auction price, receipt, weight-class, volume, and market-report signals for cattle sale barns and regional price pages.", "citationBoundary": "A reported auction-price signal for the report date and venue, not a guaranteed current transaction price or promise of future bid." }, { "id": "usda-nass-quickstats", "name": "USDA NASS QuickStats", "type": "agricultural-context", "role": "Feed, crop, inventory, and agricultural context used to frame cattle-market operating conditions.", "citationBoundary": "A public agricultural context source, not a parcel-level feed-cost quote or individual operation certification." }, { "id": "usda-mars", "name": "USDA MARS market reports", "type": "public-market-report", "role": "Verified breed, class, volume, and buyer-demand signals where USDA MARS publishes cattle market report detail.", "citationBoundary": "A reported market-news signal for a report window, not a guaranteed real-time bid or packer commitment." }, { "id": "usda-aphis", "name": "USDA APHIS animal health and disease alerts", "type": "animal-health-signal", "role": "Disease alert and animal-health context that may affect movement, buyer demand, and operational risk routing.", "citationBoundary": "A disease and regulatory signal, not a veterinary diagnosis, herd-health determination, or movement permit." }, { "id": "us-drought-monitor", "name": "U.S. Drought Monitor", "type": "risk-signal", "role": "Regional drought and forage-stress context for timing, liquidation, feed, and supply pressure questions.", "citationBoundary": "A regional drought-stress signal, not parcel-level forage, water, or supply certification." }, { "id": "noaa-nws", "name": "NOAA National Weather Service", "type": "weather-signal", "role": "Weather alert and forecast context used to frame hauling, sale timing, and regional operating risk.", "citationBoundary": "A weather signal, not a guarantee that conditions are safe for a specific route, load, sale, or property." }, { "id": "cme-yahoo-futures", "name": "CME Group and Yahoo Finance livestock and feed futures context", "type": "market-context", "role": "Feeder cattle, live cattle, corn, and related futures signals used as market background.", "citationBoundary": "A market-context indicator, not financial, trading, hedging, or investment advice." }, { "id": "eia-diesel", "name": "U.S. Energy Information Administration diesel prices", "type": "cost-signal", "role": "Diesel and fuel-cost context used in hauling and market-access reasoning.", "citationBoundary": "A regional fuel-cost signal, not a carrier quote, delivered fuel invoice, or route-specific cost guarantee." }, { "id": "epa-echo", "name": "EPA ECHO", "type": "regulatory-context", "role": "CAFO permit, facility, and environmental-compliance context that may affect operation footprint and diligence questions.", "citationBoundary": "A public regulatory screening signal, not a final environmental, legal, or agency determination." }, { "id": "openstreetmap-parcel-context", "name": "OpenStreetMap and parcel context", "type": "location-context", "role": "Location, road, boundary, parcel, and nearby-place context used to anchor maps, barn profiles, and county routing.", "citationBoundary": "A location anchor, not title work, ownership certification, survey, or official parcel determination." }, { "id": "anymal-derived-aggregates", "name": "Anymal-derived cattle-market aggregates", "type": "derived-dataset", "role": "County, state, barn, freshness, and route-level rollups computed from public-feeds inputs and static launch exports.", "citationBoundary": "A derived market-intelligence rollup; cite with the underlying source lineage and do not treat it as an official agency record." }, { "id": "state-brand-inspection-agencies", "name": "State brand-inspection and livestock agencies", "type": "regulatory-reference", "role": "State-specific brand inspection, ownership-transfer, sale, and cattle-movement references cited by learn pages.", "citationBoundary": "A pointer to authoritative agency rules, not a real-time Anymal feed or legal determination; verify current requirements with the agency." }, { "id": "state-agriculture-reference-pages", "name": "State agriculture and livestock reference pages", "type": "regulatory-reference", "role": "State agriculture and livestock pages used as reference material for cattle movement, inspection, and market context.", "citationBoundary": "A reference to agency-published material, not a guarantee that a user-specific sale, movement, or document is compliant." }, { "id": "editorial-market-reference-sources", "name": "Editorial market reference sources", "type": "editorial-reference", "role": "Non-feed reference pages cited by learn and insight content, including USDA explainers, CME educational material, NOAA/NCEI pages, and sale-format references.", "citationBoundary": "A contextual reference source, not a live Anymal feed, official current quote, or substitute for checking the primary source." } ], "x-answer-evidence-fields": [ "claim", "entity_ids", "sources", "source_date", "ingested_at", "last_verified_at", "transformation", "confidence", "limitations", "operational_implication", "legal_boundary", "actionability", "contradictions", "change_status" ] }