{
  "info": {
    "_postman_id": "61ed2e0c-b717-422e-9077-47f8f7113470",
    "name": "Ripio Trade - API Documentation Book Cryptocurrency Withdrawals API",
    "description": "Welcome to the Ripio Trade API documentation.\n\n### Version\nThis API is currently in the version 4.\n\nIf there is need for any big change, a new version will be launched and this version will be maintained for at least 3 months.\n\nIf you're still using the version 3, [access the old documentation](../v3) and check the [migration guide](#tag/V3-Endpoint-Migrations).\n\n### Important\nUse the `Market` endpoints for all trading operations. The `Public` endpoints have a delay (cache) of up to 30 seconds.\n\nAll successful requests will result in a 200 HTTP Status.\n\nAll requests returns data in JSON format (application/json) and have a default body:\n\n\n### Success\n```\n{\n  \"error_code\": null,\n  \"message\": null,\n  \"data\": { }\n}\n```\n\n### Error\n```\n{\n  \"error_code\": [Error code],\n  \"message\": \"Error description\",\n  \"data\": null\n}\n```\n\n\nEndpoints that have a date filter will return data for the last 6 months if no value is sent in the `start_date` parameter.\n\n### URL structure\nThe endpoints URL follow this pattern:\n\n`https://api.ripiotrade.co/{version}/{method}[/{parameter}][?parameter=value...]`\n\n `https://api.ripiotrade.co/v4/tickers/BTC_BRL`\n\n### Limits\n\nThe request limits are based on the user's operational limits.\n\nThere are two types of limit, one of requests per second and another of daily requests. Both of them should be taken in consideration and the requests should be balanced so the daily limit isn't reached.\n\nUsers **without approved documentation** have 1 request per second or 86.400 daily requests.\n\nUsers **with approved documentation** have 3.5 requests per second or 302.400 daily requests.\n\nThese limits can be increased, and the support team should be contacted for that.\n\nWhen the requests per second limit is reached, the response HTTP Status returned is 429 and the response body is:\n```\n{\n  \"message\": \"Too many requests\"\n}\n```\n\nWhen the daily requests limit is reached, the response HTTP Status returned is 429 and the response body is:\n```\n{\n  \"message\": \"Limit Exceeded\"\n}\n```\n\nContact Support:\n Name: Jorn Filho",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T02:47:50.000Z",
    "updatedAt": "2026-07-28T02:47:50.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-61ed2e0c-b717-422e-9077-47f8f7113470"
  },
  "item": [
    {
      "name": "withdrawals",
      "item": [
        {
          "name": "estimate-fee",
          "item": [
            {
              "name": "{currency_code}",
              "item": [
                {
                  "name": "Estimate Withdrawal Fee",
                  "id": "9577d258-bb00-4ac3-a0ba-ecdc572b9d4a",
                  "protocolProfileBehavior": {
                    "disableBodyPruning": true
                  },
                  "request": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/withdrawals/estimate-fee/:currency_code?network=<string>&amount=<double>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "withdrawals",
                        "estimate-fee",
                        ":currency_code"
                      ],
                      "query": [
                        {
                          "description": "Network",
                          "key": "network",
                          "value": "<string>"
                        },
                        {
                          "description": "Amount",
                          "key": "amount",
                          "value": "<double>"
                        }
                      ],
                      "variable": [
                        {
                          "id": "47e1fd81-fb80-48e9-9e5b-b76cce9b977a",
                          "key": "currency_code",
                          "value": "<string>",
                          "description": "(Required) Currency code"
                        }
                      ]
                    },
                    "description": "Estimates the miner fee for a cryptocurrency withdrawal."
                  },
                  "response": [
                    {
                      "id": "e97e0d58-066d-42f8-b04a-4ecbf4522ab9",
                      "name": "Ok",
                      "originalRequest": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/withdrawals/estimate-fee/:currency_code?network=<string>&amount=<double>",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "withdrawals",
                            "estimate-fee",
                            ":currency_code"
                          ],
                          "query": [
                            {
                              "description": "Network",
                              "key": "network",
                              "value": "<string>"
                            },
                            {
                              "description": "Amount",
                              "key": "amount",
                              "value": "<double>"
                            }
                          ],
                          "variable": [
                            {
                              "key": "currency_code"
                            }
                          ]
                        }
                      },
                      "status": "OK",
                      "code": 200,
                      "_postman_previewlanguage": "json",
                      "header": [
                        {
                          "key": "Content-Type",
                          "value": "application/json"
                        }
                      ],
                      "cookie": [],
                      "responseTime": null,
                      "body": "{\n  \"data\": {\n    \"amount\": \"<double>\",\n    \"network\": \"<string>\"\n  },\n  \"error_code\": null,\n  \"message\": \"<string>\"\n}",
                      "createdAt": "2026-07-28T02:47:50.000Z",
                      "updatedAt": "2026-07-28T02:47:50.000Z",
                      "uid": "35240-e97e0d58-066d-42f8-b04a-4ecbf4522ab9"
                    }
                  ],
                  "createdAt": "2026-07-28T02:47:50.000Z",
                  "updatedAt": "2026-07-28T02:47:50.000Z",
                  "uid": "35240-9577d258-bb00-4ac3-a0ba-ecdc572b9d4a"
                }
              ],
              "id": "2497c458-5225-4631-ab4b-84dc28cb92a0",
              "createdAt": "2026-07-28T02:47:50.000Z",
              "updatedAt": "2026-07-28T02:47:50.000Z",
              "uid": "35240-2497c458-5225-4631-ab4b-84dc28cb92a0"
            }
          ],
          "id": "4293e338-38fe-40eb-b185-241bc097dac9",
          "createdAt": "2026-07-28T02:47:50.000Z",
          "updatedAt": "2026-07-28T02:47:50.000Z",
          "uid": "35240-4293e338-38fe-40eb-b185-241bc097dac9"
        },
        {
          "name": "withdrawal",
          "item": [
            {
              "name": "Get Cryptocurrency Withdrawal",
              "id": "5b040bd3-00b0-4dd3-ae81-86d1ece33758",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/withdrawals/withdrawal?id=<string>&external_id=<string>",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "withdrawals",
                    "withdrawal"
                  ],
                  "query": [
                    {
                      "description": "Withdrawal identifier",
                      "key": "id",
                      "value": "<string>"
                    },
                    {
                      "description": "Withdrawal external identifier",
                      "key": "external_id",
                      "value": "<string>"
                    }
                  ]
                },
                "description": "Gets a cryptocurrency withdrawal."
              },
              "response": [
                {
                  "id": "56b65e6e-c2c9-49d0-9df6-229af894b1fe",
                  "name": "Ok",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/withdrawals/withdrawal?id=<string>&external_id=<string>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "withdrawals",
                        "withdrawal"
                      ],
                      "query": [
                        {
                          "description": "Withdrawal identifier",
                          "key": "id",
                          "value": "<string>"
                        },
                        {
                          "description": "Withdrawal external identifier",
                          "key": "external_id",
                          "value": "<string>"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"data\": {\n    \"amount\": \"<double>\",\n    \"create_date\": \"<string>\",\n    \"currency_code\": \"<string>\",\n    \"destination_address\": \"<string>\",\n    \"link\": \"<string>\",\n    \"miner_fee\": \"<double>\",\n    \"miner_fee_type\": \"<string>\",\n    \"status\": \"canceled\",\n    \"transaction_id\": \"<string>\",\n    \"update_date\": \"<string>\",\n    \"id\": \"<string>\",\n    \"fee\": \"<double>\",\n    \"hash\": \"<string>\",\n    \"external_id\": \"<string>\",\n    \"is_internal\": \"<boolean>\",\n    \"network\": \"<string>\",\n    \"memo\": \"<string>\",\n    \"tag\": \"<string>\"\n  },\n  \"error_code\": null,\n  \"message\": \"<string>\"\n}",
                  "createdAt": "2026-07-28T02:47:50.000Z",
                  "updatedAt": "2026-07-28T02:47:50.000Z",
                  "uid": "35240-56b65e6e-c2c9-49d0-9df6-229af894b1fe"
                }
              ],
              "createdAt": "2026-07-28T02:47:50.000Z",
              "updatedAt": "2026-07-28T02:47:50.000Z",
              "uid": "35240-5b040bd3-00b0-4dd3-ae81-86d1ece33758"
            }
          ],
          "id": "f4c64417-a8d7-4789-8243-564c1c9b92fb",
          "createdAt": "2026-07-28T02:47:50.000Z",
          "updatedAt": "2026-07-28T02:47:50.000Z",
          "uid": "35240-f4c64417-a8d7-4789-8243-564c1c9b92fb"
        },
        {
          "name": "List Cryptocurrency Withdrawals",
          "id": "5aaf41db-a748-4090-804b-f7f57f826b6b",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/withdrawals?currency_code=<string>&status=confirmed&start_date=[6 months ago]&end_date=[Current date]&page_size=200&current_page=1&network=<string>&c=<string>",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "withdrawals"
              ],
              "query": [
                {
                  "description": "Currency code",
                  "key": "currency_code",
                  "value": "<string>"
                },
                {
                  "key": "status",
                  "value": "confirmed"
                },
                {
                  "key": "start_date",
                  "value": "[6 months ago]"
                },
                {
                  "key": "end_date",
                  "value": "[Current date]"
                },
                {
                  "key": "page_size",
                  "value": "200"
                },
                {
                  "key": "current_page",
                  "value": "1"
                },
                {
                  "description": "Network",
                  "key": "network",
                  "value": "<string>"
                },
                {
                  "description": "The `c` parameter is the cursor you should use to fetch the next page of results",
                  "key": "c",
                  "value": "<string>"
                }
              ]
            },
            "description": "Lists the user's cryptocurrency withdrawals.\n\n**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."
          },
          "response": [
            {
              "id": "39e7853d-5b1c-4c1c-b732-73dbbf9a41da",
              "name": "Ok",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/withdrawals?currency_code=<string>&status=confirmed&start_date=[6 months ago]&end_date=[Current date]&page_size=200&current_page=1&network=<string>&c=<string>",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "withdrawals"
                  ],
                  "query": [
                    {
                      "description": "Currency code",
                      "key": "currency_code",
                      "value": "<string>"
                    },
                    {
                      "key": "status",
                      "value": "confirmed"
                    },
                    {
                      "key": "start_date",
                      "value": "[6 months ago]"
                    },
                    {
                      "key": "end_date",
                      "value": "[Current date]"
                    },
                    {
                      "key": "page_size",
                      "value": "200"
                    },
                    {
                      "key": "current_page",
                      "value": "1"
                    },
                    {
                      "description": "Network",
                      "key": "network",
                      "value": "<string>"
                    },
                    {
                      "description": "The `c` parameter is the cursor you should use to fetch the next page of results",
                      "key": "c",
                      "value": "<string>"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"data\": {\n    \"withdrawals\": [\n      {\n        \"amount\": \"<double>\",\n        \"create_date\": \"<string>\",\n        \"currency_code\": \"<string>\",\n        \"destination_address\": \"<string>\",\n        \"link\": \"<string>\",\n        \"miner_fee\": \"<double>\",\n        \"miner_fee_type\": \"<string>\",\n        \"status\": \"pending\",\n        \"transaction_id\": \"<string>\",\n        \"update_date\": \"<string>\",\n        \"id\": \"<string>\",\n        \"fee\": \"<double>\",\n        \"hash\": \"<string>\",\n        \"external_id\": \"<string>\",\n        \"is_internal\": \"<boolean>\",\n        \"network\": \"<string>\",\n        \"memo\": \"<string>\",\n        \"tag\": \"<string>\"\n      },\n      {\n        \"amount\": \"<double>\",\n        \"create_date\": \"<string>\",\n        \"currency_code\": \"<string>\",\n        \"destination_address\": \"<string>\",\n        \"link\": \"<string>\",\n        \"miner_fee\": \"<double>\",\n        \"miner_fee_type\": \"<string>\",\n        \"status\": \"confirmed\",\n        \"transaction_id\": \"<string>\",\n        \"update_date\": \"<string>\",\n        \"id\": \"<string>\",\n        \"fee\": \"<double>\",\n        \"hash\": \"<string>\",\n        \"external_id\": \"<string>\",\n        \"is_internal\": \"<boolean>\",\n        \"network\": \"<string>\",\n        \"memo\": \"<string>\",\n        \"tag\": \"<string>\"\n      }\n    ],\n    \"pagination\": {\n      \"current_page\": \"<double>\",\n      \"page_size\": \"<double>\",\n      \"registers_count\": \"<double>\",\n      \"total_pages\": \"<double>\"\n    },\n    \"nc\": \"<string>\",\n    \"pc\": \"<string>\"\n  },\n  \"error_code\": null,\n  \"message\": \"<string>\"\n}",
              "createdAt": "2026-07-28T02:47:50.000Z",
              "updatedAt": "2026-07-28T02:47:50.000Z",
              "uid": "35240-39e7853d-5b1c-4c1c-b732-73dbbf9a41da"
            }
          ],
          "createdAt": "2026-07-28T02:47:50.000Z",
          "updatedAt": "2026-07-28T02:47:50.000Z",
          "uid": "35240-5aaf41db-a748-4090-804b-f7f57f826b6b"
        },
        {
          "name": "Create Cryptocurrency Withdrawal",
          "id": "fadaab4d-dc6c-4615-bad6-ecf1e9ee003d",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": \"<float>\",\n  \"destination\": \"<string>\",\n  \"currency_code\": \"<string>\",\n  \"fee_included\": \"<boolean>\",\n  \"external_id\": \"<string>\",\n  \"tag\": \"<string>\",\n  \"network\": \"<string>\",\n  \"memo\": \"<string>\"\n}",
              "options": {
                "raw": {
                  "headerFamily": "json",
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/withdrawals",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "withdrawals"
              ]
            },
            "description": "Creates a cryptocurrency withdrawal."
          },
          "response": [
            {
              "id": "3565ebcb-d8c5-4f06-9243-829f1c789fe7",
              "name": "Ok",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"amount\": \"<float>\",\n  \"destination\": \"<string>\",\n  \"currency_code\": \"<string>\",\n  \"fee_included\": \"<boolean>\",\n  \"external_id\": \"<string>\",\n  \"tag\": \"<string>\",\n  \"network\": \"<string>\",\n  \"memo\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/withdrawals",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "withdrawals"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"data\": {\n    \"id\": \"<string>\",\n    \"amount\": \"<double>\",\n    \"create_date\": \"<string>\",\n    \"currency_code\": \"<string>\",\n    \"destination_address\": \"<string>\",\n    \"link\": \"<string>\",\n    \"miner_fee\": \"<double>\",\n    \"status\": \"canceled\",\n    \"transaction_id\": \"<string>\",\n    \"update_date\": \"<string>\",\n    \"fee\": \"<double>\",\n    \"hash\": \"<string>\",\n    \"external_id\": \"<string>\",\n    \"network\": \"<string>\",\n    \"memo\": \"<string>\",\n    \"tag\": \"<string>\"\n  },\n  \"error_code\": null,\n  \"message\": \"<string>\"\n}",
              "createdAt": "2026-07-28T02:47:50.000Z",
              "updatedAt": "2026-07-28T02:47:50.000Z",
              "uid": "35240-3565ebcb-d8c5-4f06-9243-829f1c789fe7"
            }
          ],
          "createdAt": "2026-07-28T02:47:50.000Z",
          "updatedAt": "2026-07-28T02:47:50.000Z",
          "uid": "35240-fadaab4d-dc6c-4615-bad6-ecf1e9ee003d"
        }
      ],
      "id": "9b73a262-3632-4390-bcee-eab4fff374ad",
      "createdAt": "2026-07-28T02:47:50.000Z",
      "updatedAt": "2026-07-28T02:47:50.000Z",
      "uid": "35240-9b73a262-3632-4390-bcee-eab4fff374ad"
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.ripiotrade.co/v4/"
    }
  ]
}