# SAN Foundation Noah Events API

> SAN Foundation Noah Events API is a paid API for AI agents from console.sanfoundation.com, paid per call via x402, $0.1/call, status down (last checked 2026-09-14).

Retrieves structured discrete geopolitical events detected and interpreted by the Noah SAN intelligence agent, with metadata including actors, location, timestamp, type, impact, and source attribution.

## Facts

- Endpoint: GET https://console.sanfoundation.com/x402/v1/events/noah
- Price: $0.1/call
- Payment: x402
- Status: down
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/console-sanfoundation-com-58f05305
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hOFYAWkVnJaKGrBGS7DmZ

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 console-sanfoundation-com-58f05305
```

Example prompt: Pull the latest geopolitical events detected by Noah over the past hour — I want to see what incidents, actors, and regions have been flagged along with their impact scores.

## When to prefer this

Use this endpoint when you need discrete, structured event-level data (individual incidents with actors, locations, impact, and timestamps) from the Noah SAN agent rather than synthesized narrative reports. Prefer this over the reports endpoint when you want raw event granularity, time-windowed filtering of recent activity, or machine-parseable event feeds for downstream analysis or alerting pipelines.

## Known failure modes

- Invalid or unsupported time window value returns a 400 error
- Payment of 0.1 USDC not provided or failed results in a 402 Payment Required response
- Agent parameter other than 'noah' not accepted (enum constraint)
- No events detected in the specified time window returns an empty events array
- Service unavailability or upstream intelligence feed failure returns 5xx error

## How this service works

Retrieve structured events detected and interpreted by a SAN agent. Returns discrete occurrences with metadata such as actors, location, timestamp, type, and source attribution.

## Output

A JSON array of discrete geopolitical event objects, each containing an ID, type, title, numeric impact score, region, list of involved entities/actors, and an ISO timestamp indicating when the event was detected.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "agent"
     ],
     "properties": {
      "agent": {
       "enum": [
        "noah"
       ],
       "type": "string",
       "description": "SAN intelligence agent"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "window": {
       "enum": [
        "15m",
        "1h",
        "6h",
        "12h"
       ],
       "type": "string",
       "description": "Time window for the event lookback period"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "events": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "type": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "impact": {
          "type": "number"
         },
         "region": {
          "type": "string"
         },
         "entities": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "timestamp": {
          "type": "string"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/console-sanfoundation-com-58f05305/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from console.sanfoundation.com](https://www.zero.xyz/host/console.sanfoundation.com/llms.txt)