Livestock Market Prices
Read-only, source-linked cattle, sheep, and goat prices, market reports, coverage, and methodology.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~19,149token 数（工具定义）
~35.6 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 14.96%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"livestock-market-prices": {
"url": "https://livestockmarketprices.com/mcp"
}
}
}远程端点
https://livestockmarketprices.com/mcpstreamable-http它能做什么
工具清单
工具（5）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢get_usda_cattle_benchmark
Returns the reviewed USDA Texas Weekly Cattle Auction Summary, its original reporting period, quote units, classes, weights and source link. This statewide reference is not a San Angelo cattle benchmark, another auction barn, or a local-area price. Per-head and pair quotes must not be treated as per-pound prices.
输入模式
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "usda-1955-facts-v1"
},
"id": {
"type": "string",
"pattern": "^usda-1955:[a-f0-9]{64}$"
},
"source": {
"type": "string",
"const": "USDA AMS · Texas Weekly Cattle Auction Summary"
},
"source_url": {
"type": "string",
"const": "https://mymarketnews.ams.usda.gov/viewReport/1955"
},
"state": {
"type": "string",
"const": "TX"
},
"period_begin": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"period_end": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"published_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"artifact_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"report_status": {
"type": "string",
"enum": [
"Final",
"Corrected"
]
},
"facts": {
"minItems": 1,
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"classification": {
"type": "object",
"properties": {
"category_key": {
"type": "string",
"minLength": 1
},
"class_code": {
"type": "string",
"enum": [
"kids",
"nannies_does",
"bucks_billies",
"wethers_muttons",
"lambs",
"ewes",
"rams_bucks",
"steers",
"heifers",
"cows",
"bulls",
"calves",
"cow_calf_pairs",
"other_cattle"
]
},
"purpose_code": {
"type": "string",
"enum": [
"slaughter",
"replacement",
"stocker",
"feeder",
"show",
"breeding",
"unknown"
]
},
"breed_type_code": {
"type": "string",
"enum": [
"meat_goat",
"dairy_miniature",
"angora",
"hair_sheep",
"wool_sheep",
"beef_cattle",
"dairy_cattle",
"crossbred_cattle",
"not_reported"
]
},
"sex_code": {
"type": "string",
"minLength": 1,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
},
"life_stage_code": {
"type": "string",
"minLength": 1,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
},
"quality_grade_code": {
"type": "string",
"minLength": 1,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
}
},
"required": [
"category_key",
"class_code",
"purpose_code",
"breed_type_code",
"sex_code",
"life_stage_code",
"quality_grade_code"
],
"additionalProperties": false
},
"raw_class": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"qualifiers": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"maxLength": 300
}
},
"weight": {
"type": "object",
"properties": {
"lower": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"upper": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"lower_inclusive": {
"type": [
"boolean",
"null"
]
},
"upper_inclusive": {
"type": [
"boolean",
"null"
]
},
"reported_average": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"const": "lb"
},
{
"type": "null"
}
]
}
},
"required": [
"lower",
"upper",
"lower_inclusive",
"upper_inclusive",
"reported_average",
"unit"
],
"additionalProperties": false
},
"quote": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range"
]
},
"low": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"high": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"reported_average": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"reported_weighted_average": {
"anyOf": [
{
"type": "string",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"const": "USD"
},
"unit": {
"type": "string",
"enum": [
"USD_PER_CWT",
"USD_PER_LB",
"USD_PER_HEAD",
"USD_PER_PAIR"
]
},
"measurement_basis": {
"type": "string",
"enum": [
"liveweight",
"other"
]
}
},
"required": [
"type",
"low",
"high",
"reported_average",
"reported_weighted_average",
"currency",
"unit",
"measurement_basis"
],
"additionalProperties": false
},
"head_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"row",
"classification",
"raw_class",
"qualifiers",
"weight",
"quote",
"head_count"
],
"additionalProperties": false
}
}
},
"required": [
"schema_version",
"id",
"source",
"source_url",
"state",
"period_begin",
"period_end",
"published_at",
"retrieved_at",
"artifact_sha256",
"report_status",
"facts"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"data"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_latest_prices(species, class, purpose, breed_type, weight_band, ...)
Returns a bounded list of reviewed, rights-eligible published goat, sheep, or cattle observations. Results preserve sale dates, source weight bands, quote statistics, units and measurement bases, normalized classification dimensions, dataset revision, limitations, and citations. San Angelo records remain tied to the published auction and are separately labeled for comparison rather than counted as Central Texas member data.
输入模式
{
"type": "object",
"properties": {
"species": {
"type": "string",
"enum": [
"goat",
"sheep",
"cattle"
]
},
"class": {
"type": "string",
"enum": [
"kids",
"nannies_does",
"bucks_billies",
"wethers_muttons",
"lambs",
"ewes",
"rams_bucks",
"steers",
"heifers",
"cows",
"bulls",
"calves",
"cow_calf_pairs",
"other_cattle"
]
},
"purpose": {
"type": "string",
"enum": [
"slaughter",
"replacement",
"stocker",
"feeder",
"show",
"breeding"
]
},
"breed_type": {
"type": "string",
"enum": [
"meat_goat",
"dairy_miniature",
"angora",
"hair_sheep",
"wool_sheep",
"beef_cattle",
"dairy_cattle",
"crossbred_cattle"
]
},
"weight_band": {
"type": "string",
"enum": [
"unreported",
"20-39",
"40-59",
"60-79",
"80-109",
"110-plus",
"under-300",
"300-399",
"400-499",
"500-599",
"600-699",
"700-799",
"800-999",
"1000-plus"
]
},
"location": {
"type": "string",
"maxLength": 140,
"pattern": "^(?:all|state:[A-Z]{2}:[A-Z0-9]{2,3}|region:[A-Za-z0-9][A-Za-z0-9._:-]{0,127}|market:[A-Za-z0-9][A-Za-z0-9._:-]{0,127})$"
},
"weight_lb": {
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"data": {
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"report_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"market": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"region_role": {
"type": "string",
"enum": [
"member",
"comparison_benchmark"
]
}
},
"required": [
"id",
"name",
"city",
"state",
"region_role"
],
"additionalProperties": false
},
"sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"report_status": {
"type": "string",
"enum": [
"preliminary",
"final",
"corrected"
]
},
"species": {
"type": "string",
"enum": [
"goat",
"sheep",
"cattle"
]
},
"classification": {
"type": "object",
"properties": {
"category_key": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"class_code": {
"type": "string",
"enum": [
"kids",
"nannies_does",
"bucks_billies",
"wethers_muttons",
"lambs",
"ewes",
"rams_bucks",
"steers",
"heifers",
"cows",
"bulls",
"calves",
"cow_calf_pairs",
"other_cattle"
]
},
"purpose_code": {
"type": "string",
"enum": [
"slaughter",
"replacement",
"stocker",
"feeder",
"show",
"breeding",
"unknown"
]
},
"breed_type_code": {
"type": "string",
"enum": [
"meat_goat",
"dairy_miniature",
"angora",
"hair_sheep",
"wool_sheep",
"beef_cattle",
"dairy_cattle",
"crossbred_cattle",
"not_reported"
]
},
"sex_code": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
},
"life_stage_code": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
},
"quality_grade_code": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
}
},
"required": [
"category_key",
"class_code",
"purpose_code",
"breed_type_code",
"sex_code",
"life_stage_code",
"quality_grade_code"
],
"additionalProperties": false
},
"normalized_class": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"raw_class": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"qualifiers": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"unit_inference": {
"type": "object",
"properties": {
"code": {
"type": "string",
"const": "inferred_quotation_unit"
},
"rule": {
"type": "string",
"enum": [
"cattlemens-unit-v1",
"pearsall-unit-v1",
"gonzales-unit-v1",
"brazos-valley-unit-v1"
]
},
"field": {
"type": "string",
"const": "quotation_unit"
},
"source_value": {
"type": "null"
},
"applied_value": {
"type": "string",
"enum": [
"per_cwt",
"per_lb",
"per_head",
"per_pair"
]
},
"evidence_score": {
"type": "number",
"const": 85
},
"score_is_probability": {
"type": "boolean",
"const": false
},
"explanation": {
"type": "string",
"maxLength": 500
}
},
"required": [
"code",
"rule",
"field",
"source_value",
"applied_value",
"evidence_score",
"score_is_probability",
"explanation"
],
"additionalProperties": false
},
"weight": {
"type": "object",
"properties": {
"lower": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"upper": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"lower_inclusive": {
"type": [
"boolean",
"null"
]
},
"upper_inclusive": {
"type": [
"boolean",
"null"
]
},
"reported_average": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"const": "lb"
},
{
"type": "null"
}
]
}
},
"required": [
"lower",
"upper",
"lower_inclusive",
"upper_inclusive",
"reported_average",
"unit"
],
"additionalProperties": false
},
"quote": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range"
]
},
"low": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"high": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"reported_average": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"reported_weighted_average": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"const": "USD"
},
"unit": {
"type": "string",
"enum": [
"USD_PER_CWT",
"USD_PER_LB",
"USD_PER_HEAD",
"USD_PER_PAIR"
]
},
"measurement_basis": {
"type": "string",
"enum": [
"liveweight",
"other"
]
}
},
"required": [
"type",
"low",
"high",
"reported_average",
"reported_weighted_average",
"currency",
"unit",
"measurement_basis"
],
"additionalProperties": false
},
"head_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 10000000
},
{
"type": "null"
}
]
},
"head_count_scope": {
"anyOf": [
{
"type": "string",
"enum": [
"class",
"species",
"report",
"sale",
"unknown"
]
},
{
"type": "null"
}
]
},
"boundary_semantics": {
"type": "object",
"properties": {
"lower": {
"type": "string",
"enum": [
"inclusive",
"exclusive",
"unspecified",
"open"
]
},
"upper": {
"type": "string",
"enum": [
"inclusive",
"exclusive",
"unspecified",
"open"
]
}
},
"required": [
"lower",
"upper"
],
"additionalProperties": false
},
"quotes": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"weighted_average",
"top_quote",
"selected_sale",
"individual_lot",
"typical_range",
"mostly_range",
"other"
]
},
"price_low": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"price_high": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"price_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"const": "USD"
},
"quotation_unit": {
"type": "string",
"enum": [
"per_cwt",
"per_lb",
"per_head",
"per_pair"
]
},
"measurement_basis": {
"type": "string",
"enum": [
"liveweight",
"other"
]
},
"qualifier_text": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"count_denominator": {
"anyOf": [
{
"type": "string",
"enum": [
"head",
"lot",
"liveweight",
"reported_total",
"unknown"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"statistic_type",
"price_low",
"price_high",
"price_value",
"currency",
"quotation_unit",
"measurement_basis",
"qualifier_text",
"count_denominator"
],
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"properties": {
"report_revision_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"report_revision_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"report_content_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"dataset_release_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"dataset_release_key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"publication_decision_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"publication_policy_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"normalization_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"artifact_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"source_published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"primary_source_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
},
"source_endpoint_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
}
},
"required": [
"report_revision_id",
"report_revision_number",
"report_content_sha256",
"dataset_release_id",
"dataset_release_key",
"publication_decision_id",
"publication_policy_version",
"normalization_version",
"artifact_sha256",
"source_published_at",
"retrieved_at",
"primary_source_url",
"source_endpoint_url",
"rights_url"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"id",
"report_id",
"market",
"sale_date",
"report_status",
"species",
"classification",
"normalized_class",
"raw_class",
"qualifiers",
"weight",
"quote",
"head_count",
"head_count_scope",
"boundary_semantics",
"quotes",
"provenance",
"citation"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"api_version": {
"type": "string",
"const": "1.3.0-alpha.1"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"applied_filters": {
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "number"
}
]
}
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"api_version",
"dataset_revision",
"methodology_version",
"applied_filters",
"next_cursor",
"generated_at"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta",
"citation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_market_report(report_id, observation_limit)
Returns one published report revision and a bounded observation projection. The service never exposes raw private artifacts, unpublished extraction output, internal review notes, or bucket keys.
输入模式
{
"type": "object",
"properties": {
"report_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"observation_limit": {
"default": 100,
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"report_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"source_report_key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"report_family_slug": {
"type": "string",
"enum": [
"sheep-goat",
"cattle"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"report_kind": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"presentation_role": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"report_status": {
"type": "string",
"enum": [
"preliminary",
"final",
"corrected"
]
},
"sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sale_timezone": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"report_period_start": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"report_period_end": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"report_context": {
"anyOf": [
{
"type": "object",
"properties": {
"methodologyVersion": {
"type": "string",
"const": "source-report-context-v1"
},
"sourcePriceRowCount": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000
},
{
"type": "null"
}
]
},
"counts": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"species": {
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"cattle",
"goat",
"sheep"
]
}
},
"scope": {
"type": "string",
"enum": [
"report",
"species",
"class",
"class_group",
"species_group"
]
},
"head": {
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"required": [
"label",
"species",
"scope",
"head"
],
"additionalProperties": false
}
},
"combinedQuotes": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"species": {
"minItems": 2,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"cattle",
"goat",
"sheep"
]
}
},
"quotationUnit": {
"type": "string",
"const": "per_head"
},
"priceLowUnits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"priceHighUnits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"priceScale": {
"type": "number",
"const": 2
}
},
"required": [
"label",
"species",
"quotationUnit",
"priceLowUnits",
"priceHighUnits",
"priceScale"
],
"additionalProperties": false
}
},
"notableSales": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"priceUnits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"priceScale": {
"type": "number",
"const": 2
},
"qualification": {
"type": "string",
"const": "selected_sale_not_market_range"
}
},
"required": [
"label",
"priceUnits",
"priceScale",
"qualification"
],
"additionalProperties": false
}
}
},
"required": [
"methodologyVersion",
"sourcePriceRowCount",
"counts",
"combinedQuotes"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"reported_receipt_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
{
"type": "null"
}
]
},
"quote_basis_label": {
"anyOf": [
{
"type": "string",
"maxLength": 240
},
{
"type": "null"
}
]
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_source_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
},
"source_endpoint_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
},
"market": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"locality": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"region_role": {
"type": "string",
"enum": [
"member",
"comparison_benchmark"
]
}
},
"required": [
"id",
"name",
"locality",
"state",
"country",
"canonical_url",
"region_role"
],
"additionalProperties": false
},
"publisher": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"canonical_url": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"canonical_url"
],
"additionalProperties": false
},
"revision": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"source_label": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"content_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"reviewed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"id",
"number",
"source_label",
"content_sha256",
"reviewed_at"
],
"additionalProperties": false
},
"release": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"publication_decision_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"publication_policy_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
}
},
"required": [
"id",
"key",
"publication_decision_id",
"publication_policy_version"
],
"additionalProperties": false
},
"artifact": {
"type": "object",
"properties": {
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"source_published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
}
},
"required": [
"sha256",
"retrieved_at",
"source_published_at"
],
"additionalProperties": false
},
"observations": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"report_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"market": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"region_role": {
"type": "string",
"enum": [
"member",
"comparison_benchmark"
]
}
},
"required": [
"id",
"name",
"city",
"state",
"region_role"
],
"additionalProperties": false
},
"sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"report_status": {
"type": "string",
"enum": [
"preliminary",
"final",
"corrected"
]
},
"species": {
"type": "string",
"enum": [
"goat",
"sheep",
"cattle"
]
},
"classification": {
"type": "object",
"properties": {
"category_key": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"class_code": {
"type": "string",
"enum": [
"kids",
"nannies_does",
"bucks_billies",
"wethers_muttons",
"lambs",
"ewes",
"rams_bucks",
"steers",
"heifers",
"cows",
"bulls",
"calves",
"cow_calf_pairs",
"other_cattle"
]
},
"purpose_code": {
"type": "string",
"enum": [
"slaughter",
"replacement",
"stocker",
"feeder",
"show",
"breeding",
"unknown"
]
},
"breed_type_code": {
"type": "string",
"enum": [
"meat_goat",
"dairy_miniature",
"angora",
"hair_sheep",
"wool_sheep",
"beef_cattle",
"dairy_cattle",
"crossbred_cattle",
"not_reported"
]
},
"sex_code": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
},
"life_stage_code": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
},
"quality_grade_code": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
}
},
"required": [
"category_key",
"class_code",
"purpose_code",
"breed_type_code",
"sex_code",
"life_stage_code",
"quality_grade_code"
],
"additionalProperties": false
},
"normalized_class": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"raw_class": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"qualifiers": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"unit_inference": {
"type": "object",
"properties": {
"code": {
"type": "string",
"const": "inferred_quotation_unit"
},
"rule": {
"type": "string",
"enum": [
"cattlemens-unit-v1",
"pearsall-unit-v1",
"gonzales-unit-v1",
"brazos-valley-unit-v1"
]
},
"field": {
"type": "string",
"const": "quotation_unit"
},
"source_value": {
"type": "null"
},
"applied_value": {
"type": "string",
"enum": [
"per_cwt",
"per_lb",
"per_head",
"per_pair"
]
},
"evidence_score": {
"type": "number",
"const": 85
},
"score_is_probability": {
"type": "boolean",
"const": false
},
"explanation": {
"type": "string",
"maxLength": 500
}
},
"required": [
"code",
"rule",
"field",
"source_value",
"applied_value",
"evidence_score",
"score_is_probability",
"explanation"
],
"additionalProperties": false
},
"weight": {
"type": "object",
"properties": {
"lower": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"upper": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"lower_inclusive": {
"type": [
"boolean",
"null"
]
},
"upper_inclusive": {
"type": [
"boolean",
"null"
]
},
"reported_average": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"const": "lb"
},
{
"type": "null"
}
]
}
},
"required": [
"lower",
"upper",
"lower_inclusive",
"upper_inclusive",
"reported_average",
"unit"
],
"additionalProperties": false
},
"quote": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range"
]
},
"low": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"high": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"reported_average": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"reported_weighted_average": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"const": "USD"
},
"unit": {
"type": "string",
"enum": [
"USD_PER_CWT",
"USD_PER_LB",
"USD_PER_HEAD",
"USD_PER_PAIR"
]
},
"measurement_basis": {
"type": "string",
"enum": [
"liveweight",
"other"
]
}
},
"required": [
"type",
"low",
"high",
"reported_average",
"reported_weighted_average",
"currency",
"unit",
"measurement_basis"
],
"additionalProperties": false
},
"head_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 10000000
},
{
"type": "null"
}
]
},
"head_count_scope": {
"anyOf": [
{
"type": "string",
"enum": [
"class",
"species",
"report",
"sale",
"unknown"
]
},
{
"type": "null"
}
]
},
"boundary_semantics": {
"type": "object",
"properties": {
"lower": {
"type": "string",
"enum": [
"inclusive",
"exclusive",
"unspecified",
"open"
]
},
"upper": {
"type": "string",
"enum": [
"inclusive",
"exclusive",
"unspecified",
"open"
]
}
},
"required": [
"lower",
"upper"
],
"additionalProperties": false
},
"quotes": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"weighted_average",
"top_quote",
"selected_sale",
"individual_lot",
"typical_range",
"mostly_range",
"other"
]
},
"price_low": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"price_high": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"price_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32,
"pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,9})?$"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"const": "USD"
},
"quotation_unit": {
"type": "string",
"enum": [
"per_cwt",
"per_lb",
"per_head",
"per_pair"
]
},
"measurement_basis": {
"type": "string",
"enum": [
"liveweight",
"other"
]
},
"qualifier_text": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"count_denominator": {
"anyOf": [
{
"type": "string",
"enum": [
"head",
"lot",
"liveweight",
"reported_total",
"unknown"
]
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"statistic_type",
"price_low",
"price_high",
"price_value",
"currency",
"quotation_unit",
"measurement_basis",
"qualifier_text",
"count_denominator"
],
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"properties": {
"report_revision_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"report_revision_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"report_content_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"dataset_release_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"dataset_release_key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"publication_decision_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"publication_policy_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"normalization_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"artifact_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"source_published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"primary_source_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
},
"source_endpoint_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
}
},
"required": [
"report_revision_id",
"report_revision_number",
"report_content_sha256",
"dataset_release_id",
"dataset_release_key",
"publication_decision_id",
"publication_policy_version",
"normalization_version",
"artifact_sha256",
"source_published_at",
"retrieved_at",
"primary_source_url",
"source_endpoint_url",
"rights_url"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"id",
"report_id",
"market",
"sale_date",
"report_status",
"species",
"classification",
"normalized_class",
"raw_class",
"qualifiers",
"weight",
"quote",
"head_count",
"head_count_scope",
"boundary_semantics",
"quotes",
"provenance",
"citation"
],
"additionalProperties": false
}
},
"observation_count": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"observations_truncated": {
"type": "boolean"
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"id",
"source_report_key",
"report_family_slug",
"title",
"report_kind",
"presentation_role",
"report_status",
"sale_date",
"sale_timezone",
"report_period_start",
"report_period_end",
"reported_receipt_count",
"quote_basis_label",
"canonical_url",
"primary_source_url",
"source_endpoint_url",
"market",
"publisher",
"revision",
"release",
"artifact",
"observations",
"observation_count",
"observations_truncated",
"citation"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"api_version": {
"type": "string",
"const": "1.3.0-alpha.1"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"applied_filters": {
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "number"
}
]
}
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"api_version",
"dataset_revision",
"methodology_version",
"applied_filters",
"next_cursor",
"generated_at"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta",
"citation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_data_coverage
Describes actual publishable sheep, goat, and cattle market, species, date coverage, and freshness. Configured sources are not counted as covered until eligible observations exist.
输入模式
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"release": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"observation_count": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
"quote_count": {
"type": "integer",
"minimum": 0,
"maximum": 500000000
},
"period_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"period_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"id",
"key",
"observation_count",
"quote_count",
"period_start",
"period_end"
],
"additionalProperties": false
},
"report_count": {
"type": "integer",
"minimum": 0,
"maximum": 10000000
},
"market_count": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"observation_count": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
"earliest_sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"latest_sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"markets": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"locality": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"county": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 160
},
{
"type": "null"
}
]
},
"published_species": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"cattle",
"goat",
"sheep"
]
}
},
"reported_species": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"cattle",
"goat",
"sheep"
]
}
},
"county_fips": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{3}$"
},
{
"type": "null"
}
]
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"region_role": {
"type": "string",
"enum": [
"member",
"comparison_benchmark"
]
},
"earliest_sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"latest_sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"observation_count": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
"location": {
"type": "object",
"properties": {
"address_line1": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 240
},
{
"type": "null"
}
]
},
"postal_code": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 24
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number",
"minimum": -90,
"maximum": 90
},
{
"type": "null"
}
]
},
"longitude": {
"anyOf": [
{
"type": "number",
"minimum": -180,
"maximum": 180
},
{
"type": "null"
}
]
},
"source_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"verified_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
}
},
"required": [
"address_line1",
"postal_code",
"latitude",
"longitude",
"source_url",
"verified_at"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"locality",
"state",
"country",
"county",
"county_fips",
"canonical_url",
"region_role",
"earliest_sale_date",
"latest_sale_date",
"observation_count",
"location"
],
"additionalProperties": false
}
},
"regions": {
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"slug": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"state": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2}$"
},
{
"type": "null"
}
]
},
"market_ids": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
}
}
},
"required": [
"id",
"name",
"slug",
"methodology_version",
"country",
"state",
"market_ids"
],
"additionalProperties": false
}
},
"species": {
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"goat",
"sheep",
"cattle"
]
},
"earliest_sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"latest_sale_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"observation_count": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
}
},
"required": [
"code",
"earliest_sale_date",
"latest_sale_date",
"observation_count"
],
"additionalProperties": false
}
},
"limitations": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
},
"required": [
"release",
"report_count",
"market_count",
"observation_count",
"earliest_sale_date",
"latest_sale_date",
"markets",
"regions",
"species",
"limitations"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"api_version": {
"type": "string",
"const": "1.3.0-alpha.1"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"applied_filters": {
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "number"
}
]
}
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"api_version",
"dataset_revision",
"methodology_version",
"applied_filters",
"next_cursor",
"generated_at"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta",
"citation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_methodology(version)
Returns the requested published methodology version, including exact calculation rules and limitations. It does not create a forecast, appraisal, or guaranteed selling price.
输入模式
{
"type": "object",
"properties": {
"version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"data": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"kind": {
"type": "string",
"enum": [
"publication",
"regional_reference",
"valuation",
"haul",
"sell_or_hold",
"index"
]
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"definition": {
"type": "string",
"minLength": 1,
"maxLength": 8000
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"status": {
"type": "string",
"const": "active"
},
"effective_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"id",
"kind",
"version",
"name",
"definition",
"canonical_url",
"status",
"effective_at"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"api_version": {
"type": "string",
"const": "1.3.0-alpha.1"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"applied_filters": {
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "number"
}
]
}
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"api_version",
"dataset_revision",
"methodology_version",
"applied_filters",
"next_cursor",
"generated_at"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"const": "Livestock Market Prices"
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"primary_sources": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"report_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/market-r.html"
}
]
}
},
"required": [
"publisher_name",
"report_url"
],
"additionalProperties": false
}
},
"sale_dates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"retrieved_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"dataset_revision": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"methodology_version": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"statistic_type": {
"type": "string",
"enum": [
"reported_range",
"reported_average",
"reported_weighted_average",
"publisher_top_of_market_range",
"derived_midpoint",
"derived_valuation"
]
},
"attribution_text": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"rights_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "string",
"const": "http://www.cattlemenslivestock.com/"
}
]
},
"use_requirements": {
"type": "object",
"properties": {
"source_attribution_required": {
"type": "boolean",
"const": true
},
"source_link_required": {
"type": "boolean",
"const": true
},
"claim_as_original_data_prohibited": {
"type": "boolean",
"const": true
},
"terms_url": {
"type": "string",
"const": "https://livestockmarketprices.com/terms#terms-sources"
}
},
"required": [
"source_attribution_required",
"source_link_required",
"claim_as_original_data_prohibited",
"terms_url"
],
"additionalProperties": false
}
},
"required": [
"publisher_name",
"canonical_url",
"primary_sources",
"sale_dates",
"retrieved_at",
"dataset_revision",
"methodology_version",
"statistic_type",
"attribution_text",
"rights_url",
"use_requirements"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta",
"citation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本5 个工具