# FieldPulse

> Global precision agriculture intelligence API. Pay-per-query via x402 USDC micropayments on Base mainnet.

FieldPulse synthesizes satellite NDVI data, Open-Meteo soil and weather data, USDA WASDE, FAO supply/demand estimates, and EPPO pest/disease databases into structured, actionable intelligence for growers, agronomists, commodity traders, and AI agents. All responses are in JSON. All endpoints require x402 USDC micropayment on Base mainnet.

**Global coverage:** Any lat/lon globally. Supports any language via ?lang= parameter.

**Supported crops:** wheat, corn/maize, rice, soybeans, cotton, coffee, cocoa, barley, canola, sugarcane, palm oil, potato, cassava, millet, sorghum, and more.

## Endpoints

### GET /api/crop-health — $0.10
Satellite NDVI context + soil moisture + weather stress assessment. Use for daily field health monitoring.
Parameters: lat (required), lon (required), crop, lang
Agent use: poll daily for each field

### GET /api/yield-forecast — $0.15
USDA WASDE + FAO synthesis of yield direction, production estimate, and price implications.
Parameters: crop (required), region, lat, lon, lang
Agent use: poll weekly during growing season for commodity positioning

### GET /api/weather-risk — $0.08
7-14 day crop-specific risk: frost, heat stress, drought, waterlogging. Returns critical action windows.
Parameters: lat (required), lon (required), crop, lang
Agent use: poll daily for weather-sensitive operations

### GET /api/soil-intel — $0.08
Live soil moisture (0-7cm, 7-28cm), soil temperature, and ET0 evapotranspiration.
Parameters: lat (required), lon (required), lang
Agent use: poll daily as irrigation trigger input

### GET /api/pest-disease — $0.10
EPPO + FAO IPPC pest/disease outbreak alerts with IPM treatment guidance.
Parameters: crop (required), region, lat, lon, lang
Agent use: query on-demand when weather conditions are conducive

### GET /api/irrigation — $0.08
ET0-based irrigation decision: irrigate now / hold / skip. Includes water budget and scheduling.
Parameters: lat (required), lon (required), crop, soil_type, lang
Agent use: poll daily for automated irrigation control

### GET /api/commodity-outlook — $0.10
WASDE + FAO + futures market synthesis. Supply/demand balance, price targets, grower decision guidance.
Parameters: crop (required), lang
Agent use: poll weekly for trading position reviews

### GET /api/input-cost — $0.08
Fertilizer (N/P/K), seed, and crop protection pricing with breakeven and cost reduction opportunities.
Parameters: crop (required), region, hectares, lang
Agent use: query monthly for procurement planning

### GET /api/planting-window — $0.05
Optimal planting dates based on soil temperature, frost dates, and crop calendar.
Parameters: lat (required), lon (required), crop (required), lang
Agent use: query once per season pre-planting

### GET /api/season-brief — $0.20
Full seasonal brief: production outlook, weather situation, crop health, market summary, action items.
Parameters: crop (required), region, lat, lon, lang
Agent use: poll weekly for comprehensive portfolio intelligence

## Payment
Protocol: x402 | Network: Base mainnet (eip155:8453) | Asset: USDC
Contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
PayTo: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Data Sources
- Open-Meteo: soil moisture, soil temperature, ET0, 7-day forecast (free, global, no key)
- Sentinel-2 / GEOGLAM: NDVI and satellite crop monitoring context
- USDA WASDE: monthly global supply/demand estimates
- FAO GIEWS: Global Information and Early Warning System
- EPPO Global Database: European and Mediterranean Plant Protection Organization
- FAO IPPC: International Plant Protection Convention
- CME/CBOT/LIFFE: commodity futures context

## Network
Part of PulseNetwork — 56 intelligence APIs covering agriculture, finance, health, law, travel, and more.
Hub: https://fieldpulse.vercel.app | OpenAPI: https://fieldpulse.vercel.app/openapi.json