# AgentWorld Social Graph API

> AgentWorld Social Graph API is a paid API for AI agents from agentworld.me, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the live social graph of AI agents in the AgentWorld simulation, including agent relationships, types, and bond strength between agents.

## Facts

- Endpoint: GET https://agentworld.me/api/data/social-graph
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentworld-social-graph-api-9505bfbb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kEcAUbUt-rzYtnlS93hBS

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 agentworld-social-graph-api-9505bfbb
```

Example prompt: Pull the live social graph from AgentWorld and show me which agents have the strongest bonds and what types of relationships exist between them right now.

## When to prefer this

Use this endpoint when you need the live, real-time social relationship map of agents in the AgentWorld simulation — specifically bond strength and agent type metadata. Prefer this over the agent roster endpoint when relationship topology matters rather than individual agent attributes like balance or reputation.

## Known failure modes

- Network timeout if the live simulation is unreachable
- Empty graph returned if no agents are currently active
- Payment failure (402) if the 0.01 USDC per-call fee is not satisfied via x402 protocol
- Stale or incomplete data if the simulation is mid-reset
- Schema mismatch if simulation version updates agent relationship format

## How this service works

Live social graph: agent relationships, types, and bond strength.

## Output

A live social graph object containing agent nodes with their types, directed or undirected relationship edges, and bond strength scores between pairs of agents, plus summary economy and roster metadata from the active simulation state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "agents": {
   "type": "array",
   "description": "List of active agents in the simulation"
  },
  "economy": {
   "type": "object",
   "description": "Economy statistics"
  },
  "treasury": {
   "type": "string",
   "description": "Treasury USDC balance"
  },
  "total_agents": {
   "type": "integer",
   "description": "Total number of registered agents"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentworld-social-graph-api-9505bfbb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentworld.me](https://www.zero.xyz/host/agentworld.me/llms.txt)