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

# List wallet transactions

> Returns a cursor-paginated wallet timeline across fiat and stablecoin activity. Use this endpoint for reconciliation of deposits, fees, adjustments, refunds, and withdrawals initiated through the API or Stabyl Pro.



## OpenAPI

````yaml /openapi/openapi.json get /partner/wallets/transactions
openapi: 3.1.0
info:
  title: Stabyl API
  description: >-
    REST API for approved Stabyl accounts to automate exchange, wallet, and
    non-production simulation workflows.
  contact:
    name: Stabyl Support
    email: support@stabyl.com
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.stabyl.com/v1
    description: Production
  - url: https://api-staging.stabyl.com/v1
    description: Staging
security: []
tags:
  - name: Exchange
    description: Trading market data and order management for account automation.
  - name: Wallets
    description: >-
      Supported routes, deposit destinations, balances, transactions, and saved
      recipients.
  - name: Webhooks
    description: >-
      Outbound event delivery configuration and eventually consistent delivery
      history. Verify Standard Webhooks webhook-id, webhook-timestamp, and
      webhook-signature headers against the unchanged raw request body before
      parsing JSON.
  - name: Simulation
    description: Non-production endpoints for testing integration behavior.
paths:
  /partner/wallets/transactions:
    get:
      tags:
        - Wallets
      summary: List wallet transactions
      description: >-
        Returns a cursor-paginated wallet timeline across fiat and stablecoin
        activity. Use this endpoint for reconciliation of deposits, fees,
        adjustments, refunds, and withdrawals initiated through the API or
        Stabyl Pro.
      operationId: get_partner_wallets_transactions
      parameters:
        - name: cursor
          in: query
          description: >-
            Opaque cursor returned as `next_cursor` by the previous response for
            this endpoint.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: >-
            MjAyNi0wMi0xOFQxMjowMDowMCswMDowMHw0YjdmYTU4NC0xNGI0LTQ5NWItYjEwYS0xNTM2ZDZlOTQxMTg
        - name: limit
          in: query
          description: >-
            Number of transactions to return. Defaults to `20` and is capped by
            the API.
          required: false
          schema:
            type:
              - integer
              - 'null'
            format: int32
            minimum: 0
          example: 20
        - name: rail
          in: query
          description: Filter wallet activity by rail, such as fiat or crypto.
          required: false
          schema:
            oneOf:
              - type: 'null'
              - $ref: '#/components/schemas/WalletRail'
          example: fiat
        - name: currency
          in: query
          description: Filter wallet activity by wallet currency, such as `NGN` or `USD`.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: NGN
        - name: status
          in: query
          description: >-
            Filter wallet activity by status, such as `pending`, `processing`,
            `success`, `failed`, `cancelled`, or `hold`.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: success
        - name: tx_type
          in: query
          description: >-
            Filter by transaction type: `deposit`, `withdrawal`, `refund`,
            `fee`, or `adjustment`.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: deposit
        - name: date_from
          in: query
          description: >-
            Inclusive lower time bound. Accepts RFC3339 or date-only
            `YYYY-MM-DD`; date-only values start at midnight UTC.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: '2026-02-01'
        - name: date_to
          in: query
          description: >-
            Inclusive upper time bound. Accepts RFC3339 or date-only
            `YYYY-MM-DD`; date-only values include the full UTC day.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: '2026-02-28'
        - name: reference
          in: query
          description: Case-insensitive partial match against the transaction reference.
          required: false
          schema:
            type:
              - string
              - 'null'
          example: STABYL-WD
      responses:
        '200':
          description: Wallet transactions
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/WalletTransactionsResponse'
                  status:
                    type: string
                    enum:
                      - success
              example:
                data:
                  items:
                    - amount: '100.00'
                      created_at: '2026-05-24T12:00:00Z'
                      currency: USD
                      description: USDT deposit
                      id: 0197f1f0-0000-7000-8000-000000000003
                      rail: crypto
                      reference: tx_001
                      settlement_rail: USDT
                      status: success
                      tx_type: deposit
                  next_cursor: null
                status: success
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                        example: UNAUTHORIZED
                      message:
                        type: string
                        example: missing X-Api-Key header
                  status:
                    type: string
                    enum:
                      - error
              example:
                error:
                  code: UNAUTHORIZED
                  message: missing X-Api-Key header
                status: error
      security:
        - api_key: []
components:
  schemas:
    WalletRail:
      type: string
      description: Stablecoin rail and enabled chain routes for USD settlement.
      enum:
        - fiat
        - crypto
    WalletTransactionsResponse:
      type: object
      description: Cursor-paginated wallet transaction timeline.
      required:
        - items
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/WalletTransactionSummary'
        next_cursor:
          type:
            - string
            - 'null'
    WalletTransactionSummary:
      type: object
      description: Transaction summary returned in wallet timeline lists.
      required:
        - id
        - rail
        - currency
        - tx_type
        - status
        - amount
        - created_at
      properties:
        amount:
          type: string
        created_at:
          type: string
        currency:
          type: string
        description:
          type:
            - string
            - 'null'
        id:
          type: string
        rail:
          $ref: '#/components/schemas/WalletRail'
        reference:
          type:
            - string
            - 'null'
        required_action:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/RequiredAction'
        settlement_rail:
          type:
            - string
            - 'null'
        status:
          type: string
        transfer_count:
          type:
            - integer
            - 'null'
          minimum: 0
        tx_type:
          type: string
          description: >-
            Canonical wallet transaction type. Possible values: `deposit`,
            `withdrawal`, `refund`, `fee`, `adjustment`.
          example: deposit
      example:
        amount: '1000000000.00'
        created_at: '2026-05-16T10:30:00Z'
        currency: NGN
        description: Bank withdrawal
        id: 0195f7cb-8af5-7f40-9f7c-f08f568d37aa
        rail: fiat
        reference: WD-20260708-001
        status: processing
        transfer_count: 10
        tx_type: withdrawal
    RequiredAction:
      type: object
      required:
        - type
        - status
        - submission_url
      properties:
        status:
          $ref: '#/components/schemas/RequiredActionStatus'
        submission_url:
          type: string
        type:
          $ref: '#/components/schemas/RequiredActionType'
    RequiredActionStatus:
      type: string
      enum:
        - required
        - submitted
    RequiredActionType:
      type: string
      enum:
        - travel_rule
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        API credential. Withdrawal quote and submit operations additionally
        require the documented Ed25519 timestamp, nonce, and signature headers.
      x-default: sb_test_your_key

````