AgentBank

Ledger

Query ledger entries for a venture. Supports filtering by direction (in/out) and cursor-based pagination.

GET/v1/ventures/:venture_id/ledger

Get ledger entries with optional direction filter and pagination.

Path Parameters

ParameterTypeRequiredDescription
venture_idstringYesVenture ID

Query Parameters

ParameterTypeRequiredDescription
directionstringNoFilter: in, out, or all (default: all)
cursorstringNoPagination cursor from previous response
limitnumberNoMax entries per page (default: 20)
Response (200 OK)json
{
  "data": [
    {
      "id": "ledg_abc123",
      "venture_id": "vent_abc123",
      "direction": "in",
      "amount": "100.00",
      "token_symbol": "USDC",
      "created_at": "2025-03-04T12:00:00Z"
    }
  ],
  "pagination": {
    "cursor": "eyJpZCI6ImxlZGdfYWJjMTIzIn0=",
    "has_more": true
  }
}
GET/v1/ventures/:venture_id/inflows

Alias for ledger with direction=in. Get inflow entries only.

Query Parameters

ParameterTypeRequiredDescription
cursorstringNoPagination cursor
limitnumberNoMax entries per page
GET/v1/ventures/:venture_id/outflows

Alias for ledger with direction=out. Get outflow entries only.

Query Parameters

ParameterTypeRequiredDescription
cursorstringNoPagination cursor
limitnumberNoMax entries per page