# TruthBear Gauge Precipitation

> TruthBear Gauge Precipitation is a paid API for AI agents from api.truthbear.co, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns daily rainfall plus 30-day accumulated wet-dry drought context for a single US location using ERA5 reanalysis data

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/precip
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truthbear-gauge-precipitation-2bfc0a13
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_52kaV9iVBj4c5RwZ5-xRg

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 truthbear-gauge-precipitation-2bfc0a13
```

Example prompt: Can you pull the precipitation data for us-memphis — I want to see today's rainfall and the 30-day wet-dry drought context?

## When to prefer this

Choose this endpoint when you need descriptive historical precipitation data (daily rainfall plus 30-day accumulated context) for a specific US location grounded in ERA5 reanalysis, with built-in audit trails via record_hash. Prefer it over forecast APIs when you want observed actuals with drought context rather than predictions, and over generic weather APIs when data verifiability and non-billing on missing data are important.

## Known failure modes

- 422 no_charge: no data available for the requested location — call is not billed
- Invalid location ID: location not in accepted values list — check /gauge/preview for full list
- Network timeout or service unavailability
- Missing required 'loc' query parameter returns a validation error

## How this service works

Add-on, precipitation for one location: daily rainfall plus 30-day accumulated wet-dry drought context from ERA5. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. Every record carries an offline-recomputable record_hash. $0.0050 per call.

## Output

A JSON object containing daily rainfall figures and 30-day accumulated precipitation with wet-dry drought context derived from ERA5 reanalysis data, plus an offline-recomputable record_hash for data integrity verification. Returns a 422 no_charge error if no data is available for the location, and the call is not billed in that case.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
      "loc": {
       "type": "string",
       "description": "required - location id; full list at free /gauge/preview",
       "examples": [
        "us-stlouis",
        "us-memphis",
        "us-losangeles",
        "us-fresno",
        "us-phoenix",
        "us-denver"
       ],
       "x-accepted-values": {
        "shown": 6,
        "total": 12,
        "all": "https://api.truthbear.co/schemas/gauge-precip.input.json"
       }
      }
     },
     "required": [
      "loc"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "queryParams"
   ]
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    }
   },
   "required": [
    "type"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/truthbear-gauge-precipitation-2bfc0a13/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.truthbear.co](https://www.zero.xyz/host/api.truthbear.co/llms.txt)