farm_income_and_wealth_statistics
Get ERS farm income and wealth statistics - U.S. and State-level farm sector income statements, production expenses, cash receipts, government payments, farm-related income, home consumption, inventory change, balance sheets, financial ratios, and farm business income, each pivoted to a wide layout by year.
Examples
from openbb import obb
obb.usda.farm_income_and_wealth_statistics(provider='usda')
# Get the Iowa farm income statement since 2015.
obb.usda.farm_income_and_wealth_statistics(table='income_statement', state='IA', start_year=2015, provider='usda')
# Get the U.S. farm sector balance sheet.
obb.usda.farm_income_and_wealth_statistics(table='balance_sheet', provider='usda')
# Get U.S. farm financial ratios since 2000.
obb.usda.farm_income_and_wealth_statistics(table='financial_ratios', start_year=2000, provider='usda')
Parameters
- standard
- usda
table: str | None
Default: income_statement
Description
Statement to retrieve. Each table is a set of line items keyed by year; the years become the wide columns while the line item and its unit stay as pinned row columns. The balance sheet, financial ratios, and farm business income tables are published for the United States only. Valid tables are:
income_statement, production_expenses, cash_receipts, government_payments, farm_related_income, home_consumption, inventory_change, balance_sheet, financial_ratios, farm_business_income
state: str | None
Default: US
State to retrieve, as a two-letter code, or 'US' for the national aggregate. State detail is published for the income statement, production expenses, cash receipts, government payments, farm-related income, home consumption, and inventory change tables; the U.S.-only tables accept 'US'. Forecast years are published for 'US' only.
start_year: int | None
Start year for filtering the data. If None, returns from the first published year.
end_year: int | None
End year for filtering the data. If None, returns up to the most recent forecast year.
Returns
results: FarmIncomeAndWealthStatistics
Serializable results.
provider: str | None
Provider name.
warnings: Optional[list[Warning_]]
List of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- usda
line_item: str
Published line item of the statement, as the full variable description.
unit: str
Unit of the line's values, as published, e.g. '1,000 per farm', 'Ratio', 'Percent', or '1,000 acres'.
state: str
State of the observation, or 'United States' for the national aggregate.
part_1: str | None
First component of the line-item description, as published, when the item is broken out.
part_2: str | None
Second component of the line-item description, as published, when the item is broken out.