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

# List Transfers

> Lists transfers between Ripio Wallet and Ripio Trade.

Returns paginated transfer records filtered by date range, currency, type, and status.
Use the `cursor` field from the response to navigate through pages.

---

**Authorization**

- Requires a valid API key.
- Required API-key permission(s):
  - Internal Balance Transfer (Read)



## OpenAPI

````yaml get /trade/ripio-wallet/transfer
openapi: 3.0.0
info:
  title: Ripio Gateway
  description: Ripio API - Services documentation.
  version: 0.1.0
  x-logo:
    url: https://cwstatic.nyc3.digitaloceanspaces.com/1996/bitcointrade.png
servers:
  - url: https://api.ripio.com
    description: Production environment
security: []
paths:
  /trade/ripio-wallet/transfer:
    get:
      tags:
        - Ripio Trade
      summary: Ripio Wallet - List Transfers
      description: >-
        Lists transfers between Ripio Wallet and Ripio Trade.


        Returns paginated transfer records filtered by date range, currency,
        type, and status.

        Use the `cursor` field from the response to navigate through pages.


        ---


        **Authorization**


        - Requires a valid API key.

        - Required API-key permission(s):
          - Internal Balance Transfer (Read)
      parameters:
        - in: query
          name: start_date
          required: true
          description: Initial datetime filter in ISO-8601 format
          schema:
            example: '2020-01-01T03:00:00.000Z'
            type: string
        - in: query
          name: end_date
          required: true
          description: Final datetime filter in ISO-8601 format
          schema:
            example: '2020-01-03T02:59:59.000Z'
            type: string
        - in: query
          name: page_size
          required: true
          description: Number of records per page
          schema:
            example: 100
            type: number
        - in: query
          name: type
          required: false
          description: Transfer type
          schema:
            example: deposit
            type: string
        - in: query
          name: currency_code
          required: false
          description: Currency code (BTC, ETH, USDT, ...)
          schema:
            type: string
        - in: query
          name: status
          required: false
          description: 'Transfer status filter: `pending`, `completed`, or `failed`'
          schema:
            example: pending
            type: string
        - in: query
          name: c
          required: false
          description: >-
            Cursor from the previous response to fetch the next page. Omit this
            parameter for the first page.
          schema:
            example: '2024-01-01T00:00:00.000Z'
            type: string
        - in: query
          name: order_by
          required: false
          description: Order direction
          schema:
            example: asc
            type: string
        - in: header
          name: authorization
          required: true
          description: The API key as a string.
          schema:
            type: string
        - in: header
          name: signature
          required: true
          description: >-
            See the [Generating
            Signature](/static/api/authentication#generating-signature) section
            for more details.
          schema:
            type: string
        - in: header
          name: timestamp
          required: true
          description: >-
            A timestamp in milliseconds. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
        - in: header
          name: timstamp-tolerance
          required: false
          description: >-
            An additional, non-required parameter, that you can send to specify
            the number of milliseconds after the timestamp for the request to be
            valid. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Ok
                properties:
                  data:
                    properties:
                      pc:
                        description: Previous cursor for pagination
                        type: string
                        example: '2024-01-01T00:00:00.000Z'
                      nc:
                        description: Next cursor for pagination
                        type: string
                        example: '2025-01-01T00:00:00.000Z'
                      transfers:
                        items:
                          properties:
                            created_at:
                              description: >-
                                Datetime of the transfer creation in ISO 8601
                                format
                              type: string
                              example: '2024-01-01T00:00:00.000Z'
                            status:
                              description: |-
                                Current status of the transfer:
                                - `pending`: Transfer is being processed
                                - `confirmed`: Transfer completed successfully
                                - `canceled`: Transfer was canceled
                              type: string
                              example: confirmed
                            type:
                              description: >-
                                Transfer direction type:

                                - `deposit`: Transfer from Ripio Wallet to Ripio
                                Trade (cash-in to Trade)

                                - `withdrawal`: Transfer from Ripio Trade to
                                Ripio Wallet (cash-out from Trade)
                              type: string
                              example: deposit
                            currency:
                              description: Currency code of the transfer
                              type: string
                              example: BTC
                            amount:
                              description: Amount of the transfer
                              type: string
                              example: '9.005589'
                            id:
                              description: Id of the transfer
                              type: string
                              example: vx64qwe-qwe778qwe-4qwe1dasc-qwe4
                          required:
                            - created_at
                            - status
                            - type
                            - currency
                            - amount
                            - id
                          type: object
                        type: array
                    required:
                      - transfers
                    type: object
                  error_code:
                    type: number
                    example: null
                  message:
                    type: string
                    example: null
                required:
                  - data
                  - error_code
                  - message
                type: object

````