# Ripio API

- [Ripio Retail API Overview](https://apidocs.ripio.com/static/api/overview.md): Access Ripio's Retail API to interact with wallet data and trade digital assets programmatically. REST and WebSocket endpoints for Ripio Wallet and Ripio Trade.
- [Authentication](https://apidocs.ripio.com/static/api/authentication.md): A authentication tutorial for using the Ripio API.
- [MCP Server](https://apidocs.ripio.com/static/mcp/overview.md): Connect your AI assistant to Ripio through the Model Context Protocol.
- [Basic Information](https://apidocs.ripio.com/static/wallet/introduction/basic_information.md): Welcome to the Ripio Wallet API documentation.
- [Errors](https://apidocs.ripio.com/static/wallet/introduction/errors.md): Error reference for the Ripio Wallet API.
- [Example gateway](https://apidocs.ripio.com/static/wallet/introduction/example_gateway.md)
- [Get Balances](https://apidocs.ripio.com/pages/wallet/balances/get_balances___get_balances.md): Returns wallet balances (on-chain/fiat) and viral balances (DEX tokens) for the authenticated user.
- [Get Wallet Balances](https://apidocs.ripio.com/pages/wallet/balances/get_balances___get_wallet_balances.md): Returns only the crypto and fiat wallet balances for the authenticated user.
- [Get Memecoin Balances](https://apidocs.ripio.com/pages/wallet/balances/get_balances___get_memecoin_balances.md): Returns only the memecoin (DEX) balances for the authenticated user.
- [Get Available Rails](https://apidocs.ripio.com/pages/wallet/transactions/get_transactions___get_available_rails.md): Returns the list of available transaction types for the authenticated user, grouped by rail.
- [Create A Pix Withdrawal](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___create_a_pix_withdrawal.md): Initiates a BRL withdrawal via PIX for the authenticated user.
- [List Transactions](https://apidocs.ripio.com/pages/wallet/transactions/get_transactions___list_transactions.md): Returns a cursor-paginated list of the authenticated user's transactions, restricted to the gateway's rails (`bank`, `pix`, `crypto`, `ripio`, plus `swap` with `rail=null`) and ordered by creation date descending. Transactions of other internal types (e.g. `BUY`, `SELL`) are not part of this contrac…
- [Get A Transaction By Id](https://apidocs.ripio.com/pages/wallet/transactions/get_transactions___get_a_transaction_by_id.md): Returns the details of a single transaction identified by its `id`.
- [Get Transaction Limits](https://apidocs.ripio.com/pages/wallet/transactions/get_transactions___get_transaction_limits.md): Returns the transaction limits for the authenticated user, grouped by rail.
- [Send Crypto To An External Address](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___send_crypto_to_an_external_address.md): Initiates a crypto WITHDRAWAL transaction to an external blockchain address for the authenticated user.
- [Reprocess A Crypto Receive Transaction By Hash](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___reprocess_a_crypto_receive_transaction_by_hash.md): Triggers a reprocess of a crypto receive transaction identified by its blockchain hash.
- [Create A Cvu Bank Withdrawal](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___create_a_cvu_bank_withdrawal.md): Initiates an ARS withdrawal to a registered CVU/CBU bank account for the authenticated user.
- [Send Balance To Another User Via Ripio_tag](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___send_balance_to_another_user_via_ripio_tag.md): Performs an internal balance-to-balance transfer (P2P) to another user identified by their `ripio_tag`.
- [Create A Swap Promise (quote)](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___create_a_swap_promise_(quote).md): Creates a swap promise for a currency pair. A promise is a short-lived signed quote (JWT) returned in the `uuid` field that must be sent back to `POST /transactions/swap/` to execute the swap before it expires.
- [Execute A Balance Swap From A Promise](https://apidocs.ripio.com/pages/wallet/transactions/post_transactions___execute_a_balance_swap_from_a_promise.md): Executes a swap using a previously created promise (the `uuid` token returned by `POST /transactions/quotes/`).
- [Get A Transaction By Id](https://apidocs.ripio.com/pages/wallet/transactions/get_transactions___get_a_transaction_by_id.md): Returns the details of a single transaction identified by its `id`.
- [Get Wallet Currencies](https://apidocs.ripio.com/pages/wallet/currencies/get_currencies___get_wallet_currencies.md): Returns the list of on-chain and fiat currencies available in the authenticated user's wallet.
- [Get Networks For A Currency](https://apidocs.ripio.com/pages/wallet/network/get_network___get_networks_for_a_currency.md): Returns the list of blockchain networks available for the given currency for the authenticated user.
- [Get Wallet Rates](https://apidocs.ripio.com/pages/wallet/rates/get_rates___get_wallet_rates.md): Returns the current buy/sell exchange rates for all wallet currency pairs available to the authenticated user.
- [Get Account Crypto Addresses](https://apidocs.ripio.com/pages/wallet/addresses/get_addresses___get_account_crypto_addresses.md): Returns all blockchain deposit addresses assigned to the authenticated user's account.
- [Get Account](https://apidocs.ripio.com/pages/wallet/accounts/get_accounts___get_account.md): Returns the sanitized account profile for the authenticated user. Same shape for all countries: country-specific internal fields (e.g. `cuit`/`cvu` in AR, `rfc` in MX, `paymatico_reference`/`investor_survey` in ES/CL) are not part of this public contract.
- [Health Check.](https://apidocs.ripio.com/pages/wallet/general endpoints/get_general_endpoints___health_check..md): Simple check for authentication. No permissions required.
- [List External Contacts](https://apidocs.ripio.com/pages/wallet/contacts/get_contacts___list_external_contacts.md): Returns the authenticated user's saved contacts, cursor-paginated. `crypto` and `bank` share the same underlying store and are merged into a single feed/cursor; when `contact_type` is omitted, both are returned together. `rp_tag` (internal Ripio P2P contacts) is **excluded by default**: it is only r…
- [Delete External Contact](https://apidocs.ripio.com/pages/wallet/contacts/delete_contacts___delete_external_contact.md): Deletes/unlinks a contact, identified by the composite key `(type, id)` (same pattern as `banking/accounts/{rail_type}/{id}/`): the auto-incrementing IDs of the crypto/bank store and of the rp_tag store collide with each other, so `type` is required to disambiguate and is authoritative for resolving…
- [Create External Contact (crypto, Bank Or Rp_tag)](https://apidocs.ripio.com/pages/wallet/contacts/post_contacts___create_external_contact_(crypto,_bank_or_rp_tag).md): Creates a new contact. The body field `type` discriminates the flow: `crypto` saves a blockchain address (`network` + `currency` codes), `bank` saves an AR/ARS banking account (`entity_number` — CBU/alias; **replaces the old `type=fiat`, which now responds `400`**), or `rp_tag` adds another Ripio ac…
- [Delete External Contact](https://apidocs.ripio.com/pages/wallet/contacts/delete_contacts___delete_external_contact.md): Deletes/unlinks a contact, identified by the composite key `(type, id)` (same pattern as `banking/accounts/{rail_type}/{id}/`): the auto-incrementing IDs of the crypto/bank store and of the rp_tag store collide with each other, so `type` is required to disambiguate and is authoritative for resolving…
- [List Own Bank Accounts](https://apidocs.ripio.com/pages/wallet/banking/get_banking___list_own_bank_accounts.md): Returns the list of the authenticated user's own registered bank accounts.
- [Register An Own Bank Account](https://apidocs.ripio.com/pages/wallet/banking/post_banking___register_an_own_bank_account.md): Registers a bank account owned by the authenticated user.
- [Get Own Bank Account Detail](https://apidocs.ripio.com/pages/wallet/banking/get_banking___get_own_bank_account_detail.md): Returns the detail of a specific bank account owned by the authenticated user.
- [Remove An Own Bank Account](https://apidocs.ripio.com/pages/wallet/banking/delete_banking___remove_an_own_bank_account.md): Removes a bank account owned by the authenticated user.
- [List Ripio Deposit Accounts](https://apidocs.ripio.com/pages/wallet/banking/get_banking___list_ripio_deposit_accounts.md): Returns the list of Ripio deposit accounts (fiat funding rails) the authenticated user can use to fund their account. Each list item is a discriminated union member sharing a common core (`type`, `account_number`, `account_label`, `currency`, `deposit_constraint`) plus rail-specific fields.
- [Basic Informantion](https://apidocs.ripio.com/static/trade/introduction/basic_information.md): Welcome to the Ripio Trade API documentation.
- [Errors](https://apidocs.ripio.com/static/trade/introduction/errors.md): The error code is returned in the property `code` of the response body.
- [Server Time](https://apidocs.ripio.com/pages/trade/public/get_public___server_time.md): Returns the server time in miliseconds.
- [Tickers](https://apidocs.ripio.com/pages/trade/public/get_public___tickers.md): Returns a 24 hour window statistics for all pairs.
- [Ticker By Pair](https://apidocs.ripio.com/pages/trade/public/get_public___ticker_by_pair.md): Returns a 24 hour window statistics for a given pair.
- [Orderbook Level 3](https://apidocs.ripio.com/pages/trade/public/get_public___orderbook_level_3.md): Returns the level 3 orderbook.
- [Orderbook Level 2](https://apidocs.ripio.com/pages/trade/public/get_public___orderbook_level_2.md): Returns the level 2 orderbook.
- [Trades](https://apidocs.ripio.com/pages/trade/public/get_public___trades.md): Lists the trades history based on the filtering criteria.
- [Pairs](https://apidocs.ripio.com/pages/trade/public/get_public___pairs.md): Lists the active currency pairs available in the platform.
- [Currencies](https://apidocs.ripio.com/pages/trade/public/get_public___currencies.md): Lists the active currencies available in the platform.
- [Countries](https://apidocs.ripio.com/pages/trade/public/get_public___countries.md): Lists the active countries available in the platform.
- [Operations](https://apidocs.ripio.com/pages/trade/general endpoints/get_general_endpoints___operations.md): Lists all active operation types.
- [Pairs](https://apidocs.ripio.com/pages/trade/general endpoints/get_general_endpoints___pairs.md): Lists the active currency pairs available in the platform.
- [Currencies](https://apidocs.ripio.com/pages/trade/general endpoints/get_general_endpoints___currencies.md): Lists the active currencies available in the platform.
- [Update The Amount And/or Price Of An Order](https://apidocs.ripio.com/pages/trade/orders/put_orders___update_the_amount_and_or_price_of_an_order.md): Allows update the amount and/or price of an order, it is not possible to change a canceled or fully executed order.
- [User Order By Id](https://apidocs.ripio.com/pages/trade/orders/get_orders___user_order_by_id.md): Returns the details of an order belonging to the user (by id).
- [Cancel Order](https://apidocs.ripio.com/pages/trade/orders/delete_orders___cancel_order.md): Cancels an active order by its `id`.
- [Get User Open Orders](https://apidocs.ripio.com/pages/trade/orders/get_orders___get_user_open_orders.md): Lists the user's open orders.
- [Get Trades Based On A Order Id](https://apidocs.ripio.com/pages/trade/orders/get_orders___get_trades_based_on_a_order_id.md): Get the trades from an order.
- [Cancel Order](https://apidocs.ripio.com/pages/trade/orders/post_orders___cancel_order.md): Cancels an active order by its `id` using POST.
- [Cancel Order By External Id](https://apidocs.ripio.com/pages/trade/orders/delete_orders___cancel_order_by_external_id.md): Cancels an active order by its `external_id`.
- [Cancel Order By External Id](https://apidocs.ripio.com/pages/trade/orders/post_orders___cancel_order_by_external_id.md): Cancels an active order by its `external_id` using POST.
- [Trades](https://apidocs.ripio.com/pages/trade/orders/get_orders___trades.md): Lists the trades history based on the filtering criteria.
- [User Orders](https://apidocs.ripio.com/pages/trade/orders/get_orders___user_orders.md): Lists the user's orders.
- [Create Order](https://apidocs.ripio.com/pages/trade/orders/post_orders___create_order.md): Creates a new order.
- [User Order By External Id](https://apidocs.ripio.com/pages/trade/orders/get_orders___user_order_by_external_id.md): Returns the details of a order belonging to the user (by external id).
- [Estimate Price](https://apidocs.ripio.com/pages/trade/orders/get_orders___estimate_price.md): Estimates the market unit price for a specific amount of a given currency pair.
- [Cancel All Orders](https://apidocs.ripio.com/pages/trade/orders/delete_orders___cancel_all_orders.md): Cancels all the user's active orders.
- [Statement](https://apidocs.ripio.com/pages/trade/user/get_user___statement.md): Lists the user's statement.
- [Get User Trades](https://apidocs.ripio.com/pages/trade/user/get_user___get_user_trades.md): Lists the user's trades.
- [Balances](https://apidocs.ripio.com/pages/trade/user/get_user___balances.md): Lists the user's balances
- [Balance On Date](https://apidocs.ripio.com/pages/trade/user/get_user___balance_on_date.md): Lists the user's balances in the given date.
- [Trading Fees](https://apidocs.ripio.com/pages/trade/user/get_user___trading_fees.md): Get the user trading fees
- [Statement By Currency](https://apidocs.ripio.com/pages/trade/user/get_user___statement_by_currency.md): Lists the user's statement by currency.
- [Synchronize Transaction](https://apidocs.ripio.com/pages/trade/transactions/post_transactions___synchronize_transaction.md): Manually synchronize a cryptocurrency deposit.
- [Get User Wallet](https://apidocs.ripio.com/pages/trade/wallets/get_wallets___get_user_wallet.md): Get user network's currency address
- [Tickers](https://apidocs.ripio.com/pages/trade/ticker/get_ticker___tickers.md): Returns a 24 hour window statistics for all pairs.
- [Ticker By Pair](https://apidocs.ripio.com/pages/trade/ticker/get_ticker___ticker_by_pair.md): Returns a 24 hour window statistics for a given pair.
- [Orderbook Level 3](https://apidocs.ripio.com/pages/trade/book/get_book___orderbook_level_3.md): Returns the level 3 orderbook.
- [Orderbook Level 2](https://apidocs.ripio.com/pages/trade/book/get_book___orderbook_level_2.md): Returns the level 2 orderbook.
- [List Cryptocurrency Deposits](https://apidocs.ripio.com/pages/trade/cryptocurrency deposits/get_cryptocurrency_deposits___list_cryptocurrency_deposits.md): Lists the user's cryptocurrency deposits.
- [Get Cryptocurrency Deposit](https://apidocs.ripio.com/pages/trade/cryptocurrency deposits/get_cryptocurrency_deposits___get_cryptocurrency_deposit.md): Gets a cryptocurrency deposit.
- [List Cryptocurrency Withdrawals](https://apidocs.ripio.com/pages/trade/cryptocurrency withdrawals/get_cryptocurrency_withdrawals___list_cryptocurrency_withdrawals.md): Lists the user's cryptocurrency withdrawals.
- [Create Cryptocurrency Withdrawal](https://apidocs.ripio.com/pages/trade/cryptocurrency withdrawals/post_cryptocurrency_withdrawals___create_cryptocurrency_withdrawal.md): Creates a cryptocurrency withdrawal.
- [Estimate Withdrawal Fee](https://apidocs.ripio.com/pages/trade/cryptocurrency withdrawals/get_cryptocurrency_withdrawals___estimate_withdrawal_fee.md): Estimates the miner fee for a cryptocurrency withdrawal.
- [Get Cryptocurrency Withdrawal](https://apidocs.ripio.com/pages/trade/cryptocurrency withdrawals/get_cryptocurrency_withdrawals___get_cryptocurrency_withdrawal.md): Gets a cryptocurrency withdrawal.
- [Websocket Ticket](https://apidocs.ripio.com/pages/trade/ticket/post_ticket___websocket_ticket.md): Creates a new websocket ticket. Should be sent in the body property called `ticket` to subscribe to the websocket private topics.
- [List Balances](https://apidocs.ripio.com/pages/trade/ripio wallet/get_ripio_wallet___list_balances.md): Lists user balances from the Ripio Wallet.
- [List Transfers](https://apidocs.ripio.com/pages/trade/ripio wallet/get_ripio_wallet___list_transfers.md): Lists transfers between Ripio Wallet and Ripio Trade.
- [Execute Transfer](https://apidocs.ripio.com/pages/trade/ripio wallet/post_ripio_wallet___execute_transfer.md): Executes a transfer of funds between Ripio Trade and Ripio Wallet.
- [How to subscribe to topics](https://apidocs.ripio.com/static/trade/websocket_stream/how_to_subscribe_to_topics.md): Our websocket stream service provides real time updates about market data via websocket protocol.
- [Private topics](https://apidocs.ripio.com/static/trade/websocket_stream/private_topics.md)
- [trade@BASE_QUOTE](https://apidocs.ripio.com/static/trade/websocket_stream/trade.md): Subscribe to real-time trade notifications for a specific trading pair
- [orderbook/level_3@BASE_QUOTE](https://apidocs.ripio.com/static/trade/websocket_stream/orderbook_level_3.md): Subscribe to real-time level 3 order book updates with individual order information
- [orderbook/level_2@BASE_QUOTE](https://apidocs.ripio.com/static/trade/websocket_stream/orderbook_level_2.md): Subscribe to real-time level 2 order book updates with aggregated orders by price
- [orderbook/level_2_delta@BASE_QUOTE](https://apidocs.ripio.com/static/trade/websocket_stream/orderbook_level_2_delta.md): Subscribe to real-time delta (changes) to level 2 order book
- [orderbook/level_2_with_users@BASE_QUOTE](https://apidocs.ripio.com/static/trade/websocket_stream/orderbook_level_2_with_users.md): Subscribe to real-time level 2 order book updates including user identifiers
- [ticker@BASE_QUOTE](https://apidocs.ripio.com/static/trade/websocket_stream/ticker.md): Subscribe to real-time 24-hour ticker statistics for a trading pair
- [order_status](https://apidocs.ripio.com/static/trade/websocket_stream/order_status.md): Subscribe to real-time notifications of order status changes for your account
- [balance](https://apidocs.ripio.com/static/trade/websocket_stream/balance.md): Subscribe to real-time notifications of balance changes for your account
- [user_trades](https://apidocs.ripio.com/static/trade/websocket_stream/user_trades.md): Subscribe to real-time trade notifications when your orders are matched
- [deposit](https://apidocs.ripio.com/static/trade/websocket_stream/deposit.md): Subscribe to real-time notifications of deposit events for your account
- [withdrawal](https://apidocs.ripio.com/static/trade/websocket_stream/withdrawal.md): Subscribe to real-time notifications of withdrawal events for your account
- [General API Information](https://apidocs.ripio.com/static/trade/websocket_api/general_api_information.md): The WebSocket API allows you to perform trading operations (create, cancel, and update orders) via WebSocket connection. This is separate from the WebSocket Stream service which provides real-time market data.
- [Authentication](https://apidocs.ripio.com/static/trade/websocket_api/authentication.md): The WebSocket API uses the same authentication mechanism as the REST API, including API Token, Secret, and Timestamp-based signature generation.
- [Request Format](https://apidocs.ripio.com/static/trade/websocket_api/request_format.md)
- [Response Format](https://apidocs.ripio.com/static/trade/websocket_api/response_format.md)
- [Create Order via WebSocket](https://apidocs.ripio.com/static/trade/websocket_api/create_order.md): Create a new trading order via WebSocket API
- [Cancel Order via WebSocket](https://apidocs.ripio.com/static/trade/websocket_api/cancel_order.md): Cancel an active trading order via WebSocket API
- [Update Order via WebSocket](https://apidocs.ripio.com/static/trade/websocket_api/update_order.md): Update the price and/or amount of an existing active order via WebSocket API

## OpenAPI Specs

- [openapi](/openapi.json)