> ## 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. # Get User Trades > Lists the user's trades. **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): - Trading (Read) ## OpenAPI ````yaml get /trade/user/trades 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/user/trades: get: tags: - Ripio Trade summary: User - Get User Trades description: >- Lists the user's trades. **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): - Trading (Read) parameters: - in: query name: pair required: true description: Currency pair code schema: example: BTC_BRL type: string - in: query name: start_date required: false description: >- Initial date filter in ISO-8601 format (shouldn't be before 2017-10-01) 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: order_id required: false description: Order id schema: example: F49F5BD8-3F5B-4364-BCEE-F36F62DB966A type: string - in: query name: external_id required: false description: External id schema: example: 90FcPa1Zm75 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: 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: trades: items: properties: amount: description: Amount type: number id: description: Trade id type: string price: description: Price type: number timestamp: description: Current timestamp type: number example: 1675708481219 total_value: description: Total value type: number date: description: Trade date type: string side: description: Order side (buy or sell) type: string type: description: Order type (limit or market) type: string fee: description: Exchange fee type: number fee_currency: description: Code of the currency used to charge the fee type: string example: BTC pair_code: description: Currency pair code type: string example: BTC_BRL taker_or_maker: description: Provides or removes liquidity (maker or taker) type: string example: maker maker_order_id: description: Maker order id type: string taker_order_id: description: Taker order id type: string required: - amount - id - price - timestamp - total_value - date - side - type - fee - fee_currency - pair_code - taker_or_maker - maker_order_id - taker_order_id type: object type: array example: - amount: 0.00270754 date: '2019-04-02T11:22:22.403Z' fee: 0.25 fee_currency: USDC id: 488F9395-47ED-4924-98AB-C860E1733A03 maker_order_id: 1FD30735-E055-4200-AD3D-007B02A5BA92 pair_code: BTC_USDC taker_or_maker: maker price: 18550 side: sell taker_order_id: DBC6D4AF-D454-46DF-80EC-E19528A0FB25 timestamp: 1675708481219 type: market total_value: 50.22 - amount: 0.0026938 date: '2019-04-02T11:25:41.512Z' fee: 0.00001347 fee_currency: BTC id: C79ED37D-DC21-4D54-8AFC-4262347E3F8D maker_order_id: F49F5BD8-3F5B-4364-BCEE-F36F62DB966A pair_code: BTC_USDC taker_or_maker: taker price: 18550 side: buy taker_order_id: FEAB5CEC-7F9E-4F95-B67D-9E8D5C739BE3 timestamp: 1675708481220 type: market total_value: 49.96 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: - trades - pagination type: object error_code: type: number example: null message: type: string example: null required: - data - error_code - message type: object ````