> ## Documentation Index > Fetch the complete documentation index at: https://docs.portfobit.com/llms.txt > Use this file to discover all available pages before exploring further. # List ledger entries > Requires `ledger:read` and an active Plus or Pro subscription. This is not a tax-grade PnL statement. ## OpenAPI ````yaml /openapi/portfobit-openapi.yaml get /ledger openapi: 3.1.0 info: title: Portfobit Open API version: 0.1.0 description: > Public REST API for direct API clients, CI, scripts, service accounts, third-party agents, and developer integrations. Public REST requests use scoped Portfobit Open API keys. OAuth access tokens issued for the Portfobit MCP resource are not accepted by `/api/v1/*` endpoints. Portfobit is crypto-CEX-only. Financial values are decimal strings and timestamps are RFC 3339 UTC strings. The API never supports withdrawals, external-address transfers, cross-exchange transfers, or P2P transfers. servers: - url: https://api.portfobit.com/api/v1 security: - bearerAuth: [] tags: - name: Context - name: Accounts - name: Portfolios - name: Valuation - name: Activity - name: Trading - name: Market data - name: Support paths: /ledger: get: tags: - Activity summary: List ledger entries description: >- Requires `ledger:read` and an active Plus or Pro subscription. This is not a tax-grade PnL statement. operationId: listLedgerEntries parameters: - $ref: '#/components/parameters/AccountIdQuery' - $ref: '#/components/parameters/EntryType' - $ref: '#/components/parameters/Asset' - $ref: '#/components/parameters/Symbol' - $ref: '#/components/parameters/VenueSymbol' - $ref: '#/components/parameters/From' - $ref: '#/components/parameters/To' - $ref: '#/components/parameters/CursorLimit' - $ref: '#/components/parameters/Cursor' responses: '200': $ref: '#/components/responses/LedgerResponse' '403': $ref: '#/components/responses/PlanRequiredResponse' default: $ref: '#/components/responses/ErrorResponse' components: parameters: AccountIdQuery: name: account_id in: query schema: type: string description: Restrict results to one connected CEX account. EntryType: name: entry_type in: query schema: type: string Asset: name: asset in: query schema: type: string Symbol: name: symbol in: query schema: type: string description: CCXT unified symbol. VenueSymbol: name: venue_symbol in: query schema: type: string description: Venue-native market ID, for example BTCUSDT. From: name: from in: query schema: type: string format: date-time description: Inclusive RFC 3339 UTC timestamp. To: name: to in: query schema: type: string format: date-time description: Inclusive RFC 3339 UTC timestamp. CursorLimit: name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 50 Cursor: name: cursor in: query schema: type: string description: Cursor returned as `next_cursor` by a prior page. responses: LedgerResponse: description: Ledger-entry history response. content: application/json: schema: $ref: '#/components/schemas/LedgerResponseSchema' PlanRequiredResponse: description: The operation requires an active Plus or Pro subscription. content: application/json: schema: $ref: '#/components/schemas/PlanRequiredResponseSchema' ErrorResponse: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' schemas: LedgerResponseSchema: type: object required: - data - meta properties: data: type: array items: type: object required: - id - account_id - venue - venue_entry_id - entry_type - asset - symbol - venue_symbol - direction - venue_entry_type - status - amount - fee - before_balance - after_balance - venue_reference_id - occurred_at properties: id: type: string account_id: type: string venue: type: string venue_entry_id: type: string entry_type: type: string asset: type: string symbol: type: - string - 'null' venue_symbol: type: - string - 'null' direction: type: - string - 'null' enum: - in - out - null venue_entry_type: type: - string - 'null' status: type: - string - 'null' amount: type: - string - 'null' fee: type: - object - 'null' required: - cost - currency properties: cost: type: - string - 'null' currency: type: - string - 'null' before_balance: type: - string - 'null' after_balance: type: - string - 'null' venue_reference_id: type: - string - 'null' occurred_at: type: string format: date-time meta: type: object required: - limit - next_cursor - has_next - activity_history_collection - request_id - generated_at properties: limit: type: integer next_cursor: type: - string - 'null' has_next: type: boolean activity_history_collection: type: object required: - window_days - status properties: window_days: type: integer status: type: string request_id: type: string generated_at: type: string format: date-time example: data: - id: led_01J2K8L account_id: acc_01H8XFK9A venue: binance venue_entry_id: '1502190862293484880' entry_type: funding asset: USDT symbol: BTC/USDT:USDT venue_symbol: BTCUSDT direction: out venue_entry_type: FUNDING_FEE status: ok amount: '0.00278793' fee: cost: '0.0001' currency: USDT before_balance: '100' after_balance: '99.99711207' venue_reference_id: trade_987 occurred_at: '2026-09-10T00:00:00Z' meta: limit: 50 next_cursor: null has_next: false activity_history_collection: window_days: 7 status: complete request_id: req_01J2K8B7QW generated_at: '2026-08-07T08:03:00Z' PlanRequiredResponseSchema: type: object required: - error - meta properties: error: type: object required: - code - message - details properties: code: type: string message: type: string details: type: object required: - feature - required_plan - current_plan properties: feature: type: string required_plan: type: string current_plan: type: string meta: type: object required: - request_id - generated_at properties: request_id: type: string generated_at: type: string format: date-time example: error: code: plan_required message: This operation requires an active Plus or Pro subscription. details: feature: activity_history required_plan: Plus current_plan: Free meta: request_id: req_01J2K8B7QW generated_at: '2026-08-08T08:00:00Z' ErrorEnvelope: type: object required: - error - meta properties: error: $ref: '#/components/schemas/Error' meta: $ref: '#/components/schemas/Meta' Error: type: object required: - code - message properties: code: type: string message: type: string details: type: object additionalProperties: true Meta: type: object required: - request_id - generated_at properties: request_id: type: string generated_at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Portfobit Open API key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.