# Get trades ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/account/trades: get: summary: Get trades deprecated: false description: >- Returns the authenticated account's trade history, filtered by the provided query parameters. operationId: getAccountTrades tags: - API/Trading/Trades - Trades parameters: - name: pair in: query description: Filter by pair, comma-separated. required: false example: BTC-EUR,ETH-USD schema: type: array description: Filter by pair, comma-separated. items: type: string description: Filter by pair, comma-separated. examples: - BTC-EUR,ETH-USD examples: - BTC-EUR,ETH-USD - name: orderId in: query description: Filter trades for a specific order by its unique id required: false example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 schema: type: string description: Filter trades for a specific order by its unique id examples: - a1b2c3d4-e5f6-7890-abcd-ef1234567890 - name: startTime in: query description: Start of the time range as a unix timestamp in seconds required: false example: 1726041600 schema: type: integer description: Start of the time range as a unix timestamp in seconds format: int64 examples: - 1726041600 - name: endTime in: query description: End of the time range as a unix timestamp in seconds required: false example: 1726127999 schema: type: integer description: End of the time range as a unix timestamp in seconds format: int64 examples: - 1726127999 - name: limit in: query description: Maximum number of trades to return (default 100, max 1000) required: false example: 100 schema: maximum: 1000 type: integer description: Maximum number of trades to return (default 100, max 1000) format: int32 examples: - 100 - name: cursor in: query description: Cursor from the previous response for pagination required: false example: eyJpZCI6IjEyMyJ9 schema: type: string description: Cursor from the previous response for pagination examples: - eyJpZCI6IjEyMyJ9 responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array description: List of trades matching the query parameters items: type: object properties: id: type: string description: Unique trade identifier examples: - trade-a1b2c3d4 orderId: type: string description: Identifier of the order this trade belongs to format: uuid examples: - 3aaad2dd-65ef-4ce8-98da-8af52a5b6f3e pair: type: string description: Trading pair identifier examples: - BTC-EUR side: type: string description: Trade side enum: - buy - sell examples: - sell price: type: string description: Execution price as a decimal string examples: - '61501.2' amount: type: string description: Trade quantity in base currency as a decimal string examples: - '0.15' fee: type: object properties: amount: type: string description: Fee amount as a decimal string examples: - '2.25' symbol: type: string description: Currency the fee is charged in examples: - EUR description: >- Fee charged for this trade; null if fee data is unavailable x-apidog-orders: - amount - symbol total: type: string description: >- Total trade amount in quote currency as a decimal string examples: - '9225.18' executedAt: type: string description: ISO 8601 timestamp when the trade was executed (UTC) format: date-time examples: - '2025-09-11T12:15:30.000Z' description: List of trades matching the query parameters x-apidog-orders: - id - orderId - pair - side - price - amount - fee - total - executedAt meta: type: object properties: limit: type: integer format: int32 hasNextPage: type: boolean nextCursor: type: string x-apidog-orders: - limit - hasNextPage - nextCursor x-apidog-orders: - data - meta example: data: - id: trade-a1b2c3d4 orderId: 3aaad2dd-65ef-4ce8-98da-8af52a5b6f3e pair: BTC-EUR side: sell price: '61501.20' quantity: '0.15000000' fee: amount: '2.25' currency: EUR totalAmount: '9225.18' executedAt: '2025-09-11T12:15:30.000Z' meta: limit: 100 hasNextPage: false nextCursor: null headers: {} x-apidog-name: '' '400': description: Invalid query parameter content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors example: errors: - code: VALIDATION_ERROR status: 400 field: orderId title: Invalid order ID format headers: {} x-apidog-name: '' '401': description: Unauthorized — missing or invalid authentication content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors headers: {} x-apidog-name: '' '404': description: Invalid or unknown cursor value content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors example: errors: - code: INVALID_CURSOR status: 404 field: null title: Invalid cursor headers: {} x-apidog-name: '' '500': description: Unexpected server error content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: type: string description: Machine-readable error code examples: - VALIDATION_ERROR status: type: integer description: HTTP status code format: int32 examples: - 400 field: type: string description: >- Field that caused the error; null for non-validation errors examples: - limit nullable: true title: type: string description: Human-readable error message examples: - Invalid value for parameter 'limit' x-apidog-orders: - code - status - field - title x-apidog-orders: - errors example: errors: - code: 500 INTERNAL_SERVER_ERROR status: 500 field: null title: An unexpected error occurred headers: {} x-apidog-name: '' security: - ApiKeyAuth: [] x-apidog: schemeGroups: - id: 4VSjjLAMXBsbeSoHH3Yw_ schemeIds: - ApiKeyAuth required: true use: id: 4VSjjLAMXBsbeSoHH3Yw_ scopes: 4VSjjLAMXBsbeSoHH3Yw_: ApiKeyAuth: [] x-apidog-folder: API/Trading/Trades x-apidog-status: released x-run-in-apidog: https://app.eu.apidog.com/web/project/363759/apis/api-4203920-run components: schemas: {} securitySchemes: ApiKeyAuth: type: apikey description: API key for authentication. Issued by Bitpanda. name: x-api-key in: header servers: - url: https://api.fusion.bitpanda.com description: Production security: [] ```