# SAN Foundation Agent Events Feed

> SAN Foundation Agent Events Feed is a paid API for AI agents from gateway.sanfoundation.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns recent canonical events for a specified SAN agent, with each event collapsing matching source articles into a single deduplicated record including source count and sources array.

## Facts

- Endpoint: GET https://gateway.sanfoundation.com/x402/v1/agents/Noah/events
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gateway-sanfoundation-com-4ea0df0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bQlg1Gh6oYCJq8Q3_lRDn

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 gateway-sanfoundation-com-4ea0df0f
```

Example prompt: Show me the 10 most recent canonical events tracked by the SAN agent named Noah, including how many sources each event cites.

## When to prefer this

Use this endpoint when you need a deduplicated, source-attributed event feed for a specific SAN agent rather than raw search results or full reports. Prefer this over the single-event lookup endpoint when you want a batch of recent events, and over the reports endpoint when you want raw event data rather than audience-lensed narrative summaries. Ideal for monitoring what a SAN agent has been tracking recently or building downstream pipelines that need source provenance.

## Known failure modes

- Agent reference not found — returns 404 or empty result if the name/slug/UUID does not match any known SAN agent
- Limit out of range — returns validation error if limit is below 1 or above 30
- Payment not processed — x402 payment required; returns 402 if USDC payment of $0.03 is not completed
- No events available — returns empty events array if the agent has no recent canonical events
- Malformed pathParams — missing or invalid ref field causes bad request error

## How this service works

Returns Noah agent event data for monitoring and integrations.

## Output

Returns a JSON object containing the agent metadata and an array of canonical event records (up to 30). Each event has been collapsed from multiple matching source articles into a single record, with a sourceCount integer and a sources[] array listing the underlying articles, plus event metadata such as id (evt_…), title, and timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "ref": "Noah"
  },
  "queryParams": {
   "limit": 10
  }
 }
}
```

## 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": [
      "ref"
     ],
     "properties": {
      "ref": {
       "type": "string",
       "description": "Agent reference: name (case-insensitive), slug, UUID, or external id (e.g. '017')."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 30,
       "minimum": 1,
       "description": "Max events to return (default 10, max 30)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "agent": {
       "type": "object"
      },
      "count": {
       "type": "integer"
      },
      "events": {
       "type": "array",
       "items": {
        "type": "object"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

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