Sentinel

Query payment and audit records from the Sentinel API. Used by the dashboard when configured with apiKey and baseUrl.

List Payments

GET /api/v1/payments

Query Parameters

Param	Type	Description
`agent_id`	`string`	Filter by agent external ID
`category`	`string`	Filter by category
`network`	`string`	Filter by network (e.g., eip155:8453)
`status`	`string`	Filter by status
`from`	`string`	Start time (ISO or unix ms)
`to`	`string`	End time
`min_amount`	`number`	Minimum amount in USD
`max_amount`	`number`	Maximum amount in USD
`cursor`	`string`	Pagination cursor
`limit`	`number`	Max results (default 50, max 200)
`sort`	`string`	timestamp_desc \| timestamp_asc \| amount_usd_desc \| amount_usd_asc

Response

{
  "data": [
    {
      "id": "...",
      "agent_external_id": "agent-1",
      "amount_usd": 0.5,
      "endpoint_domain": "api.example.com",
      "tx_hash": "0x...",
      "status": "settled",
      "created_at": "2024-02-22T12:00:00Z"
    }
  ],
  "next_cursor": "1700000000000",
  "total": 42
}

Get Payment by ID

GET /api/v1/payments/:id

Returns a single payment record or 404.

CSV Export

GET /api/v1/payments/export?format=csv&from=...&to=...

Export payments as CSV for compliance reviews.

curl Example