> ## 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 Cryptocurrency Withdrawals

> Lists the user's cryptocurrency withdrawals.

**Attention:** Due to performance concerns, this endpoint now uses cursor-based pagination. The pagination object currently included in the response is now a placeholder and will be entirely removed as of 2026-06-01. The parameter current_page is also a placeholder and will be removed at the same time. Please update your integration accordingly and refer to the documentation for the correct pagination handling.

---

**Authorization**

- Requires a valid API key.
- Required API-key permission(s):
  - Withdrawal (Read)



## OpenAPI

````yaml get /trade/withdrawals
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/withdrawals:
    get:
      tags:
        - Ripio Trade
      summary: Cryptocurrency Withdrawals - List Cryptocurrency Withdrawals
      description: >-
        Lists the user's cryptocurrency withdrawals.


        **Attention:** Due to performance concerns, this endpoint now uses
        cursor-based pagination. The pagination object currently included in the
        response is now a placeholder and will be entirely removed as of
        2026-06-01. The parameter current_page is also a placeholder and will be
        removed at the same time. Please update your integration accordingly and
        refer to the documentation for the correct pagination handling.


        ---


        **Authorization**


        - Requires a valid API key.

        - Required API-key permission(s):
          - Withdrawal (Read)
      parameters:
        - in: query
          name: currency_code
          required: false
          description: Currency code
          schema:
            example: BTC
            type: string
        - in: query
          name: status
          required: false
          description: Withdrawal status
          schema:
            type: string
        - in: query
          name: start_date
          required: false
          description: Initial date filter in ISO-8601 format
          schema:
            type: string
        - in: query
          name: end_date
          required: false
          description: Final date filter in ISO-8601 format
          schema:
            type: string
        - in: query
          name: page_size
          required: false
          description: Number of records per page
          schema:
            example: 100
            type: number
        - in: query
          name: current_page
          required: false
          description: Page number for pagination
          schema:
            example: 3
            type: number
        - in: query
          name: network
          required: false
          description: Network
          schema:
            example: bitcoin
            type: string
        - in: query
          name: c
          required: false
          description: >-
            The `c` parameter is the cursor you should use to fetch the next
            page of results
          schema:
            example: BTC
            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:
                      withdrawals:
                        items:
                          properties:
                            amount:
                              description: Amount
                              type: number
                              example: 0.1
                            create_date:
                              description: Datetime of the creation
                              type: string
                              example: '2019-01-25T16:37:15.443Z'
                            currency_code:
                              description: Currency code
                              type: string
                              example: BTC
                            destination_address:
                              description: Destination address
                              type: string
                              example: rw9nf3WgsagJiZnkAeZzXZuqeCQ6LHm2h1
                            external_id:
                              description: >-
                                External id (this is sent by the user when
                                creating a withdrawal, and it's optional)
                              type: string
                              example: rtd-9012-lkju-908
                            is_internal:
                              description: Flag that indicates if it's an internal wallet
                              type: boolean
                              example: false
                            link:
                              description: Withdrawal link
                              type: string
                              example: null
                            miner_fee:
                              description: Miner fee
                              type: number
                              example: 0
                            miner_fee_type:
                              description: Miner fee type
                              type: string
                              example: 1
                            network:
                              description: Network
                              type: string
                              example: bitcoin
                            status:
                              description: Withdrawal status
                              type: string
                            transaction_id:
                              description: Transaction id
                              type: string
                              example: null
                            update_date:
                              description: Datetime of the last update
                              type: string
                              example: '2019-01-25T16:37:15.443Z'
                            id:
                              description: Withdrawal identifier
                              type: string
                              example: A1DCD3B6-1CBD-4F17-ADA0-230ADEC04173
                            fee:
                              description: Fee charged by the exchange
                              type: number
                              example: 0
                            hash:
                              description: Transaction hash
                              type: string
                              example: null
                            memo:
                              description: >-
                                Destination address memo - Check the information
                                about this currency in the public currencies
                                endpoint to check if this currency / network
                                offers memo for withdrawals
                              type: string
                            tag:
                              description: >-
                                Destination address tag - Check the information
                                about this currency in the public currencies
                                endpoint to check if this currency / network
                                offers tag for withdrawals
                              type: string
                          required:
                            - amount
                            - create_date
                            - currency_code
                            - destination_address
                            - link
                            - miner_fee
                            - miner_fee_type
                            - status
                            - transaction_id
                            - update_date
                            - id
                            - fee
                            - hash
                          type: object
                        type: array
                        example:
                          - amount: 0.1
                            create_date: '2019-01-25T16:37:15.443Z'
                            currency_code: BTC
                            destination_address: rw9nf3WgsagJiZnkAeZzXZuqeCQ6LHm2h1
                            external_id: rtd-9012-lkju-908
                            is_internal: true
                            link: null
                            miner_fee: 0.000012
                            miner_fee_type: regular
                            network: bitcoin
                            status: pending
                            transaction_id: 5890ASHIUHC089189YSHBNJKHAG978891
                            update_date: '2019-01-25T16:37:15.017Z'
                            id: A1DCD3B6-1CBD-4F17-ADA0-230ADEC04173
                            fee: 0
                            hash: null
                            memo: '656899'
                            tag: '0100000020'
                          - amount: 0.1
                            create_date: '2019-01-25T16:37:15.443Z'
                            currency_code: BTC
                            destination_address: rw9nf3WgsagJiZnkAeZzXZuqeCQ6LHm2h1
                            external_id: rtd-9012-lkju-908
                            is_internal: true
                            link: null
                            miner_fee: 0.000012
                            miner_fee_type: regular
                            network: bitcoin
                            status: pending
                            transaction_id: 5890ASHIUHC089189YSHBNJKHAG978891
                            update_date: '2019-01-25T16:37:15.017Z'
                            id: A1DCD3B6-1CBD-4F17-ADA0-230ADEC04173
                            fee: 0
                            hash: null
                            memo: '656899'
                            tag: '0100000020'
                      pagination:
                        properties:
                          current_page:
                            description: Current page
                            type: number
                          page_size:
                            description: Page size
                            type: number
                          registers_count:
                            description: Total number of registers
                            type: number
                          total_pages:
                            description: Total number of pages
                            type: number
                        required:
                          - current_page
                          - page_size
                          - registers_count
                          - total_pages
                        type: object
                        example:
                          current_page: 1
                          registers_count: 21
                          total_pages: 1
                          page_size: 100
                      nc:
                        description: >-
                          This is the next cursor, use its value with the `c`
                          parameter to retrieve the next page
                        type: string
                      pc:
                        description: >-
                          This is the previous cursor, use its value with the
                          `c` parameter to retrieve the previous page
                        type: string
                    required:
                      - withdrawals
                      - pagination
                    type: object
                  error_code:
                    type: number
                    example: null
                  message:
                    type: string
                    example: null
                required:
                  - data
                  - error_code
                  - message
                type: object

````