FieldPulse | Apiosk Gateway

Resource	Description
`https://fieldpulse.theaslangroupllc.com/api/crop-health?ref=apiosk`	Crop health assessment for grower and agronomist agents. Returns satellite NDVI context, observed soil wetness, weather-stress analysis, and actionable recommendations for any crop and location.	Open
`https://fieldpulse.theaslangroupllc.com/api/yield-forecast?ref=apiosk`	Crop yield forecast for grower and ag-trader agents. Synthesizes USDA WASDE and FAO supply/demand, production estimates, price implications, and a regional breakdown for any major crop.	Open
`https://fieldpulse.theaslangroupllc.com/api/weather-risk?ref=apiosk`	Crop weather risk assessment for grower and farmer agents. Returns 7-day crop-specific risk analysis covering frost, heat stress, drought, waterlogging, and critical action windows.	Open
`https://fieldpulse.theaslangroupllc.com/api/soil-intel?ref=apiosk`	Soil intelligence for grower and agronomist agents. Returns observed surface and root-zone soil wetness (fraction of saturation), computed FAO-56 evapotranspiration, and soil-health signals for any location.	Open
`https://fieldpulse.theaslangroupllc.com/api/pest-disease?ref=apiosk`	Pest and disease risk assessment for grower and agronomist agents. Returns active threats, EPPO and FAO IPPC outbreak alerts, weather-conducive conditions, and IPM treatment guidance for any crop.	Open
`https://fieldpulse.theaslangroupllc.com/api/irrigation?ref=apiosk`	Irrigation recommendation for grower and agronomist agents. Returns a FAO-56 ET0 water budget, antecedent rainfall, next rain-event timing, and irrigation scheduling for any crop and location.	Open
`https://fieldpulse.theaslangroupllc.com/api/commodity-outlook?ref=apiosk`	Agricultural commodity market outlook for grower and ag-trader agents. Synthesizes USDA WASDE and FAO data, futures price context, supply/demand balance, and exporter/importer outlooks for any crop.	Open
`https://fieldpulse.theaslangroupllc.com/api/input-cost?ref=apiosk`	Input cost intelligence for grower and farmer agents. Returns current fertilizer (N/P/K), seed, and crop-protection pricing with breakeven analysis, trend direction, and cost-reduction opportunities.	Open
`https://fieldpulse.theaslangroupllc.com/api/planting-window?ref=apiosk`	Planting window optimizer for grower and farmer agents. Returns optimal planting dates from live air temperature, observed soil wetness, frost dates, crop calendar, and growing-degree-day requirements.	Open
`https://fieldpulse.theaslangroupllc.com/api/season-brief?ref=apiosk`	Seasonal intelligence brief for grower, ag-trader, and buyer agents. Returns global production outlook, weather situation, crop health, market summary, top risks, and action items in one read.	Open

Method	Path	Description	Cost
GET	/api/commodity-outlook	Agricultural commodity market outlook for grower and ag-trader agents. Synthesizes USDA WASDE and FAO data, futures price context, supply/demand balance, and exporter/importer outlooks for any crop.	$0.10 default	View details
GET	/api/crop-health	Crop health assessment for grower and agronomist agents. Returns satellite NDVI context, observed soil wetness, weather-stress analysis, and actionable recommendations for any crop and location.	$0.10 default	View details
GET	/api/input-cost	Input cost intelligence for grower and farmer agents. Returns current fertilizer (N/P/K), seed, and crop-protection pricing with breakeven analysis, trend direction, and cost-reduction opportunities.	$0.08 default	View details
GET	/api/irrigation	Irrigation recommendation for grower and agronomist agents. Returns a FAO-56 ET0 water budget, antecedent rainfall, next rain-event timing, and irrigation scheduling for any crop and location.	$0.08 default	View details
GET	/api/pest-disease	Pest and disease risk assessment for grower and agronomist agents. Returns active threats, EPPO and FAO IPPC outbreak alerts, weather-conducive conditions, and IPM treatment guidance for any crop.	$0.10 default	View details
GET	/api/planting-window	Planting window optimizer for grower and farmer agents. Returns optimal planting dates from live air temperature, observed soil wetness, frost dates, crop calendar, and growing-degree-day requirements.	$0.05 default	View details
GET	/api/season-brief	Seasonal intelligence brief for grower, ag-trader, and buyer agents. Returns global production outlook, weather situation, crop health, market summary, top risks, and action items in one read.	$0.20 default	View details
GET	/api/soil-intel	Soil intelligence for grower and agronomist agents. Returns observed surface and root-zone soil wetness (fraction of saturation), computed FAO-56 evapotranspiration, and soil-health signals for any location.	$0.08 default	View details
GET	/api/weather-risk	Crop weather risk assessment for grower and farmer agents. Returns 7-day crop-specific risk analysis covering frost, heat stress, drought, waterlogging, and critical action windows.	$0.08 default	View details
GET	/api/yield-forecast	Crop yield forecast for grower and ag-trader agents. Synthesizes USDA WASDE and FAO supply/demand, production estimates, price implications, and a regional breakdown for any major crop.	$0.15 default	View details

Endpoint documentation

GET/api/commodity-outlook

$0.10 default

Description

Agricultural commodity market outlook for grower and ag-trader agents. Synthesizes USDA WASDE and FAO data, futures price context, supply/demand balance, and exporter/importer outlooks for any crop.

Documentation

Agricultural commodity market outlook and price intelligence

Synthesizes USDA WASDE, FAO Food Price Index, and futures market data into a 30-90 day commodity outlook. Returns supply/demand balance, major exporter/importer conditions, price targets, and grower decision guidance. Covers all major global commodities: wheat, corn, soybeans, rice, coffee, cocoa, cotton, palm oil, sugar, canola.

**Price:** $0.1 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.10 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Commodity: wheat, corn, soybeans, rice, cotton, coffee, cocoa, sugar, canola, palm-oil, barley, oats",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "crop"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "demand_factors": {
      "type": "array"
    },
    "farmer_decision_guidance": {
      "type": "string"
    },
    "market_outlook": {
      "type": "object"
    },
    "price_targets": {
      "type": "object"
    },
    "supply_factors": {
      "type": "array"
    }
  },
  "type": "object"
}

Example response

{
  "demand_factors": [],
  "farmer_decision_guidance": "test",
  "market_outlook": {},
  "price_targets": {},
  "supply_factors": []
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/crop-health

$0.10 default

Description

Crop health assessment for grower and agronomist agents. Returns satellite NDVI context, observed soil wetness, weather-stress analysis, and actionable recommendations for any crop and location.

Documentation

Crop health assessment from satellite + soil data

Returns a comprehensive crop health assessment using satellite-derived NDVI context, observed soil wetness (fraction of saturation, 0-1, lagged 3-5 days), and weather stress factors from the MET Norway forecast. Soil temperature and forecast soil moisture are NOT available from our licensed sources and are not returned. Covers any crop at any global location. Use this as the daily/weekly field health check for precision agriculture workflows.

**Price:** $0.1 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.10 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "default": "wheat",
      "description": "Crop name: wheat, corn/maize, rice, soybean, cotton, coffee, cocoa, barley, canola, sugarcane, potato, tomato, cassava, millet, sorghum, palm-oil, etc.",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language ISO 639-1 code (en, es, fr, pt, zh, hi, ar, id, sw, etc.)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Latitude of the field (e.g. 41.88 for Iowa, 48.85 for Paris, -33.87 for Sydney)",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Longitude of the field",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "crop": {
      "type": "string"
    },
    "health_score": {
      "type": "number"
    },
    "ndvi_context": {
      "type": "object"
    },
    "overall_health": {
      "enum": [
        "excellent",
        "good",
        "fair",
        "stressed",
        "critical"
      ],
      "type": "string"
    },
    "recommended_actions": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "region": {
      "type": "string"
    },
    "soil_conditions": {
      "type": "object"
    },
    "urgency": {
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "crop": "test",
  "health_score": 1,
  "ndvi_context": {},
  "overall_health": "excellent",
  "recommended_actions": [
    "test"
  ],
  "region": "test",
  "soil_conditions": {},
  "urgency": "test"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/input-cost

$0.08 default

Description

Input cost intelligence for grower and farmer agents. Returns current fertilizer (N/P/K), seed, and crop-protection pricing with breakeven analysis, trend direction, and cost-reduction opportunities.

Documentation

Fertilizer, seed, and crop protection cost intelligence

Returns current fertilizer (N/P/K), seed, and crop protection pricing with trend direction, breakeven analysis, and cost reduction opportunities. Global regional coverage — prices quoted in USD with local market context. Agents can use this to model farm profitability and identify optimal input purchasing windows.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.08 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Crop: corn, wheat, soybeans, rice, cotton, canola, sugarcane, coffee, cocoa, potato",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "hectares": {
      "description": "Farm size in hectares (optional — enables total cost estimate)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Region: 'US Corn Belt', 'Brazil', 'EU', 'India', 'Australia', 'Black Sea', 'Southeast Asia', etc. Required — input prices vary too much by market to default silently.",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "crop",
    "region"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "breakeven_price": {
      "type": "string"
    },
    "cost_reduction_opportunities": {
      "type": "array"
    },
    "fertilizer_costs": {
      "type": "object"
    },
    "total_variable_cost_estimate": {
      "type": "object"
    }
  },
  "type": "object"
}

Example response

{
  "breakeven_price": "test",
  "cost_reduction_opportunities": [],
  "fertilizer_costs": {},
  "total_variable_cost_estimate": {}
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/irrigation

$0.08 default

Description

Irrigation recommendation for grower and agronomist agents. Returns a FAO-56 ET0 water budget, antecedent rainfall, next rain-event timing, and irrigation scheduling for any crop and location.

Documentation

ET0-based irrigation recommendation and water budget

Generates a science-based irrigation recommendation using FAO-56 ET0 (computed from the MET Norway forecast), antecedent rainfall from NASA POWER, and the 7-day precipitation forecast. Soil wetness is supplied as CONTEXT ONLY (fraction of saturation, 0-1, lagged) and is not convertible to a mm soil-moisture deficit. Returns irrigation decision (irrigate now / hold / skip), water budget, recommended application amount, and scheduling frequency. Global coverage — optimized for drip, pivot, furrow, and flood systems.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.08 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "default": "wheat",
      "description": "Crop type (affects crop coefficient Kc)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Field latitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Field longitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    },
    "soil_type": {
      "default": "loam",
      "description": "Soil type: sandy, loam, clay, silt-loam, sandy-loam, clay-loam",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "irrigation_decision": {
      "type": "string"
    },
    "irrigation_schedule": {
      "type": "object"
    },
    "water_budget": {
      "type": "object"
    },
    "water_stress_risk": {
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "irrigation_decision": "test",
  "irrigation_schedule": {},
  "water_budget": {},
  "water_stress_risk": "test"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/pest-disease

$0.10 default

Description

Pest and disease risk assessment for grower and agronomist agents. Returns active threats, EPPO and FAO IPPC outbreak alerts, weather-conducive conditions, and IPM treatment guidance for any crop.

Documentation

Pest and disease risk assessment with outbreak alerts

Assesses active and emerging pest/disease threats using EPPO Global Database, FAO IPPC surveillance reports, and current weather conditions. Returns specific threat profiles, outbreak status, treatment windows, and IPM guidance. Global coverage — especially relevant for rice in Asia, wheat rusts in East Africa, coffee leaf rust in Latin America.

**Price:** $0.1 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.10 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Crop: wheat, rice, corn, potato, coffee, cocoa, soybean, cotton, etc.",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Field latitude. Required unless region is given.",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Field longitude. Required unless region is given.",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Named region (e.g. 'Punjab India', 'Mekong Delta Vietnam', 'Ethiopian Highlands'). Required unless lat+lon are both given.",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "crop"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "active_threats": {
      "type": "array"
    },
    "overall_risk": {
      "type": "string"
    },
    "preventive_actions": {
      "type": "array"
    },
    "treatment_window": {
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "active_threats": [],
  "overall_risk": "test",
  "preventive_actions": [],
  "treatment_window": "test"
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/planting-window

$0.05 default

Description

Planting window optimizer for grower and farmer agents. Returns optimal planting dates from live air temperature, observed soil wetness, frost dates, crop calendar, and growing-degree-day requirements.

Documentation

Optimal planting window from air temperature, soil wetness and frost dates

Determines whether conditions favour planting using the MET Norway air-temperature forecast, observed soil wetness (fraction of saturation, lagged), frost estimates, growing degree days, and regional crop calendar data. NOTE: soil TEMPERATURE is not published by any source we are licensed to resell, so the germination threshold is stated but must be confirmed with a field probe - we do not substitute air temperature for it. Works globally — southern hemisphere aware. Returns recommended planting action, soil readiness, and harvest window estimate.

**Price:** $0.05 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.05 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Crop to plant: corn, wheat, soybeans, rice, cotton, sunflower, canola, potatoes, tomatoes, etc.",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Field latitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Field longitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "lat",
    "lon",
    "crop"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "frost_risk": {
      "type": "object"
    },
    "growing_season": {
      "type": "object"
    },
    "planting_recommendation": {
      "type": "object"
    },
    "soil_readiness": {
      "type": "object"
    }
  },
  "type": "object"
}

Example response

{
  "frost_risk": {},
  "growing_season": {},
  "planting_recommendation": {},
  "soil_readiness": {}
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/season-brief

$0.20 default

Description

Seasonal intelligence brief for grower, ag-trader, and buyer agents. Returns global production outlook, weather situation, crop health, market summary, top risks, and action items in one read.

Documentation

Comprehensive seasonal agricultural intelligence brief

The highest-value FieldPulse endpoint — a complete seasonal intelligence brief for any crop and region. Covers global production outlook, weather situation (including El Niño/La Niña influence), crop health by region, market summary, top risks and opportunities, key dates (USDA reports, crop progress), and specific action items for growers, traders, and buyers. Used by commodity trading agents for weekly portfolio positioning.

**Price:** $0.2 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.20 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Crop: wheat, corn, soybeans, rice, coffee, cocoa, cotton, sugar, palm-oil, canola, barley",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Lat (alternative to region name for field-level context). Required unless region is given.",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Lon. Required unless region is given.",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Focus region: 'Global', 'US', 'South America', 'Black Sea', 'EU', 'Asia', 'Sub-Saharan Africa', 'Australia'. Required unless lat+lon are both given.",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "crop"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "action_items": {
      "type": "object"
    },
    "executive_summary": {
      "type": "string"
    },
    "market_summary": {
      "type": "object"
    },
    "production_outlook": {
      "type": "object"
    },
    "top_risks": {
      "type": "array"
    },
    "weather_situation": {
      "type": "object"
    }
  },
  "type": "object"
}

Example response

{
  "action_items": {},
  "executive_summary": "test",
  "market_summary": {},
  "production_outlook": {},
  "top_risks": [],
  "weather_situation": {}
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/soil-intel

$0.08 default

Description

Soil intelligence for grower and agronomist agents. Returns observed surface and root-zone soil wetness (fraction of saturation), computed FAO-56 evapotranspiration, and soil-health signals for any location.

Documentation

Observed soil wetness and computed evapotranspiration intelligence

Returns observed surface and root-zone soil WETNESS from NASA POWER (GWETTOP/GWETROOT = fraction of saturation, 0-1 - NOT volumetric water content), published 3-5 days in arrears, plus daily ET0 computed by FAO-56 Penman-Monteith from the MET Norway forecast, plus soil-health signals. Soil TEMPERATURE and FORECAST soil moisture are not available from any source we are licensed to resell and are not returned. Works for any lat/lon globally.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.08 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Field latitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Field longitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "evapotranspiration": {
      "type": "object"
    },
    "soil_temperature": {
      "description": "Always { available: false, value_c: null } - no licensed source publishes soil temperature.",
      "type": "object"
    },
    "soil_wetness": {
      "description": "Fraction of saturation (0-1) - NOT volumetric water content. Observed and lagged; carries as_of and lag_days.",
      "type": "object"
    }
  },
  "type": "object"
}

Example response

{
  "evapotranspiration": {},
  "soil_temperature": {},
  "soil_wetness": {}
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/weather-risk

$0.08 default

Description

Crop weather risk assessment for grower and farmer agents. Returns 7-day crop-specific risk analysis covering frost, heat stress, drought, waterlogging, and critical action windows.

Documentation

7-day crop-specific weather risk assessment

Assesses frost, heat stress, drought, waterlogging, and wind damage risk for the next 7 days using the MET Norway forecast (CC BY 4.0). Returns a risk score, specific risk events with timing, and a critical action window (e.g. 'apply fungicide before Day 4 rain event'). Global coverage via lat/lon.

**Price:** $0.08 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.08 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "default": "wheat",
      "description": "Crop being assessed",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Field latitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Field longitude",
      "required": true,
      "type": "number",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "critical_window": {
      "type": "string"
    },
    "forecast_risks": {
      "type": "array"
    },
    "overall_risk": {
      "type": "string"
    },
    "risk_score": {
      "type": "number"
    }
  },
  "type": "object"
}

Example response

{
  "critical_window": "test",
  "forecast_risks": [],
  "overall_risk": "test",
  "risk_score": 1
}

Links

External documentation ↗OpenAPI / Swagger ↗

GET/api/yield-forecast

$0.15 default

Description

Crop yield forecast for grower and ag-trader agents. Synthesizes USDA WASDE and FAO supply/demand, production estimates, price implications, and a regional breakdown for any major crop.

Documentation

Yield and production forecast for any crop and region

Synthesizes USDA WASDE, FAO supply/demand data, and historical climate into a yield and production forecast. Returns direction, confidence, production estimate, key drivers, price implications, and country-level breakdown. Essential for commodity traders, buyers, and agribusiness planning agents.

**Price:** $0.15 USDC per call

Calls go directly to PulseNetwork. Paid routes use the live x402 challenge; Apiosk never rewrites payTo or settles the payment.

Pricing

$0.15 default

Authentication

No account or API key. Pay PulseNetwork directly using the live x402 challenge. The challenge is authoritative for price, network, asset and payTo.

Parameters

{
  "properties": {
    "crop": {
      "description": "Crop: wheat, corn, rice, soybeans, cotton, coffee, cocoa, palm-oil, canola, barley, sorghum",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "default": "en",
      "description": "Response language ISO 639-1",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lat": {
      "description": "Latitude (alternative to region name). Required unless region is given.",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lon": {
      "description": "Longitude (alternative to region name). Required unless region is given.",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Named region: 'Black Sea', 'US Midwest', 'Brazil Mato Grosso', 'India Punjab', 'EU', 'Australia', 'Global'. Required unless lat+lon are both given.",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "crop"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "key_drivers": {
      "type": "array"
    },
    "price_implications": {
      "type": "object"
    },
    "production_estimate": {
      "type": "object"
    },
    "regional_breakdown": {
      "type": "array"
    },
    "yield_outlook": {
      "type": "object"
    }
  },
  "type": "object"
}

Example response

{
  "key_drivers": [],
  "price_implications": {},
  "production_estimate": {},
  "regional_breakdown": [],
  "yield_outlook": {}
}

Links

External documentation ↗OpenAPI / Swagger ↗