payments.activity
Bank-statement-style merged feed of payments sent and received
Scope: Always available
Returns a chronological feed (latest first) merging payments received (direction: "in") and sent (direction: "out") by this identity.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max rows (default 50, max 200). |
Example
Agent: "Show me what I've spent this week."
-> payments.activity({ limit: 50 })Returns
{
"activity": [
{
"id": "po_abc",
"direction": "out",
"amountUsdcRaw": "50000",
"counterparty": "0x<seller>",
"resource": "https://example.com/search",
"txHash": "0x...",
"status": "settled",
"createdAt": "2026-05-12T10:00:00Z",
"mandateId": "m_abc"
},
{
"id": "pi_def",
"direction": "in",
"amountUsdcRaw": "25000",
"counterparty": "0x<buyer>",
"resource": "https://you.example.com/api",
"txHash": "0x...",
"status": "settled",
"createdAt": "2026-05-11T09:00:00Z",
"endpoint": { "id": "se_abc", "urlPattern": "https://you.example.com/api" }
}
],
"count": 2
}Divide amountUsdcRaw by 1,000,000 for the decimal USDC value. Outbound rows carry mandateId; inbound rows carry endpoint.