> ## Documentation Index
> Fetch the complete documentation index at: https://kamino.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk get KVault transactions

> Bulk get all Kamino Earn Vault transactions with paginated access (max 1000 transactions returned in each response). Private (authorized) API access only, please add a basic auth header to your request.



## OpenAPI

````yaml /kamino-api.json post /kvaults/transactions
openapi: 3.1.0
info:
  version: 1.0.0
  title: Kamino Public API
  description: >
    The Kamino API provides a comprehensive way to interact with Kamino without
    reading directly from the blockchain.


    The API also provides the ability to fetch data that might not be available
    from just reading the chain.


    The API is rate-limited for unauthenticated users. If you feel you need to
    make more requests or run into rate-limit issues, please reach out.
servers:
  - url: https://api.kamino.finance
security: []
paths:
  /kvaults/transactions:
    post:
      tags:
        - Kamino Earn Vaults
      summary: Bulk get KVault transactions
      description: >-
        Bulk get all Kamino Earn Vault transactions with paginated access (max
        1000 transactions returned in each response). Private (authorized) API
        access only, please add a basic auth header to your request.
      parameters:
        - schema:
            type: string
            default: KvauGMspG5k6rtzrqqn7WNn3oZdyKqLKwK2XWQ8FLjd
            description: Fetch transactions from this program id
          required: false
          description: Fetch transactions from this program id
          name: programId
          in: query
        - schema:
            type: string
            default: false
          required: false
          name: includeRawJson
          in: query
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                start:
                  anyOf:
                    - type: string
                    - type: number
                  description: Date input (ISO 8601 string or epoch in ms)
                  examples:
                    - '2024-01-01T00:00:00.000Z'
                    - 1704067200000
                  example: 2020-01-01T00:00Z
                end:
                  anyOf:
                    - type: string
                    - type: number
                  description: Date input (ISO 8601 string or epoch in ms)
                  examples:
                    - '2024-01-01T00:00:00.000Z'
                    - 1704067200000
                  example: 2020-02-01T00:00Z
                instruction:
                  type: string
                  example: buy
                  examples:
                    - buy
                    - sell
                    - deposit
                    - withdraw
                    - invest
                    - withdrawAvailable
                  description: Kvault instruction name
                paginationToken:
                  type: string
                  example: eyJsYXN0SWQiOjgxfQ==
                  description: Optional pagination token
              required:
                - instruction
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/KvaultBulkTransaction'
                  paginationToken:
                    type: string
                    example: eyJsYXN0SWQiOjgxfQ==
                    description: >-
                      Optional pagination token - if not present you have
                      reached the end
                required:
                  - result
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: High-level error message describing the failure
                    example: Invalid query params
                  details:
                    type: array
                    items:
                      type: object
                      additionalProperties: {}
                    description: >-
                      Detailed validation issues (present only for validation
                      errors)
                required:
                  - error
                description: Bad request response (400)
                example:
                  error: Invalid query request
                  details:
                    - code: invalid_union
                      errors:
                        - - code: custom
                            path: []
                            message: Invalid date string
                        - - expected: number
                            code: invalid_type
                            path: []
                            message: 'Invalid input: expected number, received string'
                      path:
                        - start
                      message: Invalid input
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message describing why it was not authorized
                    example: >-
                      Not authorized for this request. Please include the basic
                      auth headers.
                required:
                  - error
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    KvaultBulkTransaction:
      type: object
      properties:
        ix:
          $ref: '#/components/schemas/KvaultEnrichedInstruction'
        timestamp:
          allOf:
            - $ref: '#/components/schemas/SnapshotDateTime'
            - description: Timestamp when the transaction was executed (ISO 8601 format)
              example: '2025-03-01T12:00:00.000Z'
        signature:
          type: string
          description: Transaction signature
          example: >-
            2XWcSQVtR4NoHBhzYpDkYkmYtEFkFXC5ZwrKiPok1kvA86GvnN15qP7RNP6eTeNWgJqgnR1GA2M3QPp1hucW7e1v
        kvault:
          allOf:
            - $ref: '#/components/schemas/AddressBase58'
            - description: Valid base58-encoded address of the vault
              example: HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E
        wallet:
          allOf:
            - $ref: '#/components/schemas/AddressBase58'
            - description: Valid base58-encoded address of the user wallet
              example: AxqtG9SHDkZTLSWg81Sp7VqAzQpRqXtR9ziJ3VQAS8As
        rawJson:
          type: string
          description: Entire raw JSON of the instruction
      required:
        - ix
        - timestamp
        - signature
        - kvault
        - wallet
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message for internal server failure
          example: An internal error occurred
      required:
        - error
      description: Internal server error response (500)
      example:
        error: An internal error occurred
    KvaultEnrichedInstruction:
      type: object
      properties:
        market:
          type: string
          description: KLend market public key
          example: EyV4jxSMd6vpuRgrxMFem7CKRhcB4Vv6WMRDtxPQNP4
        reserve:
          type: string
          description: KLend reserve public key
          example: ALnjBHECcdBsSwgVJ6A8pFEZ15qxE5jJQriCXSKT3Bte
        solPrice:
          $ref: '#/components/schemas/Decimal'
        sharePrice:
          $ref: '#/components/schemas/Decimal'
        tokenPrice:
          $ref: '#/components/schemas/Decimal'
        tokenAmount:
          $ref: '#/components/schemas/Decimal'
        numberOfShares:
          $ref: '#/components/schemas/Decimal'
      required:
        - solPrice
        - sharePrice
        - tokenPrice
        - tokenAmount
        - numberOfShares
      description: Enriched kvault instruction object
      example:
        tokenAmount: '835.924775'
        numberOfShares: '814.34612'
        solPrice: '138.7776002'
        sharePrice: '1.0263403430350673002'
        tokenPrice: '0.99984713'
    SnapshotDateTime:
      type: string
      format: date-time
      description: Timestamp of the metrics snapshot
      example: '2023-06-29T15:15:26.464Z'
    AddressBase58:
      type: string
      description: Valid base58-encoded address
      example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd
    Decimal:
      type: string
      description: Decimal value represented as string
      example: '1234.56789'

````