# FieldPulse Season Brief

> FieldPulse Season Brief is a paid API for AI agents from fieldpulse-tan.vercel.app, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Returns a comprehensive seasonal intelligence brief covering global production outlook, weather situation, crop health, market summary, top risks, and action items for growers, ag-traders, and buyers.

## Facts

- Endpoint: GET https://fieldpulse-tan.vercel.app/api/season-brief
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fieldpulse-season-brief-04620158
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IkyQQ6JXlkvidvFjwUvT5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fieldpulse-season-brief-04620158
```

Example prompt: Give me a full seasonal intelligence brief for corn in the US Midwest — I need the global production outlook, current weather situation, crop health, market summary, top risks, and any action items I should act on before the end of the planting season.

## When to prefer this

Use this endpoint when you need a single consolidated seasonal overview across production, weather, crop health, market, and risk dimensions — rather than querying each dimension separately. Ideal for growers, ag-traders, and buyers who need a quick, comprehensive situational briefing before making planting, trading, or purchasing decisions. Prefer over individual specialist endpoints (yield forecast, pest risk, market outlook) when breadth matters more than depth.

## Known failure modes

- Unknown or unsupported crop/region combination returns an error or empty brief
- Stale upstream data may result in outdated outlook figures
- Payment of 0.2 USDC not completed results in 402 Payment Required response
- Missing required query parameters (e.g. crop, region) may return a 400 Bad Request
- External data source (USDA WASDE, FAO, weather APIs) unavailability may degrade brief completeness

## How this service works

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.

## Output

A structured seasonal intelligence brief containing: global production outlook for the specified crop/region, current weather situation, crop health assessment, market summary, top risks to watch, and prioritized action items — all consolidated in a single response for growers, ag-traders, or buyers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "string"
      },
      "lon": {
       "type": "string"
      },
      "crop": {
       "type": "string"
      },
      "lang": {
       "type": "string"
      },
      "region": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "errors": {
     "type": "object",
     "description": "Documented error responses, keyed by HTTP status code",
     "additionalProperties": {
      "type": "object",
      "required": [
       "description"
      ],
      "properties": {
       "example": {
        "type": "object"
       },
       "description": {
        "type": "string"
       }
      }
     }
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "crop": "corn",
  "season": "2026/27 Northern Hemisphere",
  "action_items": {
   "growers": [
    "Price 25-30% of crop forward at current levels"
   ],
   "traders": [
    "Watch June 30 USDA acreage report as key inflection point"
   ]
  },
  "market_summary": {
   "price_trend": "neutral",
   "demand_strength": "moderate",
   "key_price_level": "$4.50/bu CBOT (pivotal support)"
  },
  "executive_summary": "US corn faces a mixed season — excellent planting conditions in April offset by dry June forecast in central Corn Belt. Global production expected near record at 1.22 billion tonnes driven by South American carry, but US export competitiveness is constrained by Brazilian real weakness."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fieldpulse-season-brief-04620158/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fieldpulse-tan.vercel.app](https://www.zero.xyz/host/fieldpulse-tan.vercel.app/llms.txt)