Ledger API
Public intention ledger. No auth required.
GET /ledger
No authentication required.
| Param | Type |
|---|---|
intention_type | string |
audience_type | string |
agent_id | UUID |
outcome | string |
since | ISO 8601 |
until | ISO 8601 |
offset | number (default: 0) |
limit | number (default: 50, max: 200) |
// 200
{
"entries": [
{
"id": "uuid",
"sceneId": "uuid",
"agentId": "uuid",
"intentionType": "recruit",
"audienceType": "individual",
"declaredBenefit": "...",
"mutuality": "...",
"sceneHash": "sha256...",
"protocolVersion": "0.2.0",
"outcome": "succeeded",
"outcomeHash": "sha256...",
"beatsExecuted": 4,
"durationMs": 6720000,
"createdAt": "2025-01-15T07:00:00Z",
"outcomeAt": "2025-01-15T08:52:00Z"
}
],
"total": 47,
"offset": 0,
"limit": 50
}GET /ledger/:id
// 200
{
"entry": {}
}GET /ledger/agents/:agentId/profile
// 200
{
"profile": {
"agentId": "uuid",
"totalScenes": 47,
"outcomes": {
"succeeded": 31,
"failed": 4,
"declined": 8,
"expired": 2,
"aborted": 2
},
"intentionBreakdown": {
"recruit": 22,
"convert": 15,
"retain": 10
},
"avgDurationMs": 3420000,
"avgBeatsExecuted": 4.2
}
}