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

# List Transactions

> List transactions for a specific wallet or all wallets with filtering options.

**Required API Key Scopes:** `read`



## OpenAPI

````yaml https://api-bluvo.com/api/v0/openapi get /v0/wallet/transactions
openapi: 3.1.0
info:
  title: Bluvo API (v0)
  description: APIs to supercharge your crypto project.
  version: 0.0.3
  termsOfService: https://bluvo.co/terms
  contact:
    name: Bluvo
    email: help@bluvo.co
    url: https://bluvo.co
servers:
  - url: https://api-bluvo.com
    description: Production Server
  - url: https://test.api-bluvo.com
    description: Development Server
security: []
paths:
  /v0/wallet/transactions:
    get:
      tags:
        - Wallets
      summary: List Transactions
      description: >-
        List transactions for a specific wallet or all wallets with filtering
        options.


        **Required API Key Scopes:** `read`
      operationId: wallettransactionslisttransactions
      parameters:
        - name: page
          in: query
          required: false
          description: Page number (0-indexed).
          schema:
            type:
              - integer
              - 'null'
            minimum: 0
            maximum: 1000
        - name: limit
          in: query
          required: false
          description: Number of transactions per page (max 1000).
          schema:
            type:
              - integer
              - 'null'
            minimum: 1
            maximum: 1000
        - name: sinceDate
          in: query
          required: false
          description: Filter transactions after this date (ISO format).
          schema:
            type:
              - string
              - 'null'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        walletId:
                          type: string
                        createdAt:
                          anyOf:
                            - type: string
                            - type: number
                            - type: string
                            - type: 'null'
                        updatedAt:
                          anyOf:
                            - type: string
                            - type: number
                            - type: string
                            - type: 'null'
                        timestamp:
                          anyOf:
                            - type: string
                            - type: number
                            - type: string
                            - type: 'null'
                        type:
                          type: string
                          enum:
                            - deposit
                            - withdrawal
                            - transaction
                        amount:
                          type: number
                        currency:
                          type: string
                        direction:
                          type:
                            - string
                            - 'null'
                          enum:
                            - in
                            - out
                            - null
                        feeCost:
                          type:
                            - number
                            - 'null'
                        feeCurrency:
                          type:
                            - string
                            - 'null'
                        amountInFiat:
                          type:
                            - number
                            - 'null'
                        feeInFiat:
                          type:
                            - number
                            - 'null'
                        fiatCurrency:
                          type:
                            - string
                            - 'null'
                          enum:
                            - USD
                            - EUR
                            - null
                        status:
                          type: string
                          enum:
                            - pending
                            - ok
                            - failed
                            - canceled
                        addressTo:
                          type:
                            - string
                            - 'null'
                        network:
                          type:
                            - string
                            - 'null'
                        addressFrom:
                          type:
                            - string
                            - 'null'
                        hash:
                          type:
                            - string
                            - 'null'
                        contractAddress:
                          type:
                            - string
                            - 'null'
                        tag:
                          type:
                            - string
                            - 'null'
                        exchange:
                          type:
                            - string
                            - 'null'
                        rawResponse: {}
                      required:
                        - id
                        - walletId
                        - type
                        - amount
                        - currency
                        - status
                  pagination:
                    type: object
                    properties:
                      totalCount:
                        type: number
                      page:
                        type: integer
                      limit:
                        type: integer
                      pageCount:
                        type: number
                      offset:
                        type: number
                    required:
                      - totalCount
                      - page
                      - limit
                      - pageCount
                      - offset
                required:
                  - transactions
                  - pagination
              example:
                transactions:
                  - id: tx_01H9X3Z7N5V2KJ4G8P6QR5T3Y2
                    walletId: wallet_01H9X3Z7N5V2KJ4G8P6QR5T3Y2
                    createdAt: 1713897600000
                    updatedAt: 1713897600000
                    timestamp: 1713897600000
                    type: withdrawal
                    amount: 0.1
                    currency: BTC
                    direction: out
                    feeCost: 0.0001
                    feeCurrency: BTC
                    amountInFiat: 9650.5
                    feeInFiat: 9.65
                    fiatCurrency: USD
                    status: ok
                    addressTo: bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq
                    network: bitcoin
                    addressFrom: null
                  - id: tx_02G8Y4Z8M6W3LK5H7P7RS6T4Z3
                    walletId: wallet_01H9X3Z7N5V2KJ4G8P6QR5T3Y2
                    createdAt: 1713897000000
                    updatedAt: 1713897000000
                    timestamp: 1713897000000
                    type: deposit
                    amount: 1.5
                    currency: ETH
                    direction: in
                    feeCost: 0.005
                    feeCurrency: ETH
                    amountInFiat: 5425.75
                    feeInFiat: 18.09
                    fiatCurrency: USD
                    status: ok
                    addressTo: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
                    network: ethereum
                    addressFrom: null
                pagination:
                  totalCount: 25
                  page: 0
                  limit: 10
                  pageCount: 3
                  offset: 0
        '403':
          description: Forbidden - Insufficient API key permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  type:
                    type: string
                    const: APIKEY_INSUFFICIENT_PERMISSIONS
                  missing:
                    type: array
                    items:
                      type: string
                required:
                  - error
                  - type
                  - missing
              example:
                error: Insufficient permissions
                type: APIKEY_INSUFFICIENT_PERMISSIONS
                missing:
                  - read
      security:
        - bluvoApiKey:
            - x-bluvo-api-key
          bluvoOrgId:
            - x-bluvo-org-id
          bluvoProjectId:
            - x-bluvo-project-id
components:
  securitySchemes:
    bluvoApiKey:
      type: apiKey
      name: x-bluvo-api-key
      in: header
      description: Bluvo API Key
    bluvoOrgId:
      type: apiKey
      name: x-bluvo-org-id
      in: header
      description: Bluvo Organization ID
    bluvoProjectId:
      type: apiKey
      name: x-bluvo-project-id
      in: header
      description: Bluvo Project ID

````