> ## 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 Open Orders > Lists the user's open orders. --- **Authorization** - Requires a valid API key. - Required API-key permission(s): - Trading (Read) ## OpenAPI ````yaml get /trade/orders/open 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/orders/open: get: tags: - Ripio Trade summary: Orders - Get User Open Orders description: |- Lists the user's open orders. --- **Authorization** - Requires a valid API key. - Required API-key permission(s): - Trading (Read) parameters: - in: query name: pair required: false description: Currency pair code schema: example: BTC_BRL type: string - in: query name: side required: false description: Order side (buy or sell) 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: 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: orders: items: properties: id: description: Order identifier type: string create_date: description: Creation datetime type: string executed_amount: description: Executed amount type: number external_id: description: >- External id (this is sent by the user when creating an order, and it's optional) type: string pair: description: Currency pair code type: string example: BTC_BRL remaining_amount: description: Remaining amount type: number remaining_value: description: Remaining value type: number requested_amount: description: Requested amount type: number requested_value: description: Requested value type: number status: description: >- Order status (executed_completely / executed_partially / open / canceled) type: string type: description: Order type (limit / market) type: string total_value: description: Total value type: number side: description: Order side (buy or sell) type: string price: description: Price type: number update_date: description: Datetime of the last update type: string fee: description: Fee from the transaction type: number fill_or_kill: description: >- Exclusive for StopLimit orders, it is used in stop-loss or stop-buy scenarios to initiate selling or buying when the market price reaches the specified stop price type: boolean required: - id - create_date - executed_amount - pair - remaining_amount - remaining_value - requested_amount - status - type - total_value - side - price - update_date - fee - fill_or_kill type: object type: array example: - create_date: '2017-12-08T23:42:54.960Z' executed_amount: 0.02347418 external_id: B4A9F7F4-9C79-4921-9330-224C17260BDF id: 857C0A3B-D70F-4256-9051-1C62FADBA8FA pair: BTC_BRL price: 42600 remaining_amount: 0 remaining_value: 0 requested_amount: 0.02347418 requested_value: 1000 side: buy status: executed_completely fee: 0.004 total_value: 1000 type: limit update_date: '2017-12-13T21:48:48.817Z' - create_date: '2017-10-20T00:26:40.403Z' executed_amount: 0.00033518 external_id: 13080055-7357-4110-81B1-981E6699FA57 id: 3ECBE371-DE24-42E8-841C-4281B3164CCE pair: BTC_BRL price: 16352.12 remaining_amount: 0 remaining_value: 0 requested_amount: 0.00033518 requested_value: 5.48090358 side: buy status: executed_completely fee: 0.004 total_value: 5.48090358 type: limit update_date: '2017-10-20T00:26:40.467Z' 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: Next cursor for pagination type: string pc: description: Previous cursor for pagination type: string required: - orders - pagination type: object error_code: type: number example: null message: type: string example: null required: - data - error_code - message type: object ````