> ## Documentation Index > Fetch the complete documentation index at: https://developers.circle.com/llms.txt > Use this file to discover all available pages before exploring further. # Get all trades > Returns a paginated list of all trades. ## OpenAPI ````yaml openapi/stablefx.yaml get /v1/exchange/stablefx/trades openapi: 3.1.0 info: title: StableFX API description: > The StableFX API provides endpoints for trading stablecoins. ## Authentication All API requests require authentication using an API key. ## Base URL The base URL for all API endpoints is: `https://api.circle.com/v1/exchange/stablefx` version: 1.0.0 servers: - url: https://api.circle.com description: StableFX API server security: - BearerAuth: [] tags: - name: Quotes description: Endpoints for creating and managing quotes - name: Trades description: Endpoints for creating and managing trades - name: Signatures description: Endpoints for retrieving presign typed data and registering signatures - name: Fees description: Endpoints for retrieving fees - name: Funding description: Endpoints for funding trades - name: Webhook Subscriptions description: Manage subscriptions to notifications - name: Settlement Advance description: Request, track, and repay settlement advances. paths: /v1/exchange/stablefx/trades: get: tags: - Trades summary: Get all trades description: Returns a paginated list of all trades. operationId: listTrades parameters: - $ref: '#/components/parameters/Status' - $ref: '#/components/parameters/Asset' - $ref: '#/components/parameters/Id' - $ref: '#/components/parameters/Ids' - $ref: '#/components/parameters/PageSize' - $ref: '#/components/parameters/From' - $ref: '#/components/parameters/To' - in: query name: type required: true description: The type of trade. schema: $ref: '#/components/schemas/Type' - in: query name: settlementTransactionHash required: false description: Filter trades by settlement transaction hash. schema: type: string pattern: ^0x[a-fA-F0-9]{64}$ example: '0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122' responses: '200': description: Trade retrieved successfully content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Trade' security: - BearerAuth: [] components: parameters: Status: name: status description: The status of the trade to filter by. in: query required: false schema: $ref: '#/components/schemas/TradeStatus' Asset: name: asset description: Filter trades by asset currency. in: query required: false schema: $ref: '#/components/schemas/Currency' Id: name: id description: Filter trades by a single trade ID or ID prefix. in: query required: false schema: type: string minLength: 1 maxLength: 36 Ids: name: ids description: Filter trades by one or more trade IDs. in: query required: false schema: type: array items: type: string format: uuid minItems: 1 style: form explode: true PageSize: name: pageSize description: > Limits the number of items to be returned. Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used. If avoided, the collection will determine the page size itself. in: query schema: type: integer default: 50 maximum: 200 minimum: 1 From: name: from description: >- Queries items created since the specified date-time (inclusive) in ISO 8601 format. in: query schema: type: string format: date-time example: '2023-01-01T12:04:05Z' To: name: to description: >- Queries items created before the specified date-time (inclusive) in ISO 8601 format. in: query schema: type: string format: date-time example: '2023-01-01T12:04:05Z' schemas: Type: type: string description: The type of trader. enum: - maker - taker Trade: type: object description: A StableFX trade created from a quote. properties: id: $ref: '#/components/schemas/Id' contractTradeId: $ref: '#/components/schemas/ContractTradeId' status: $ref: '#/components/schemas/TradeStatus' rate: $ref: '#/components/schemas/Rate' from: $ref: '#/components/schemas/CurrencyAmount' to: $ref: '#/components/schemas/CurrencyAmount' fee: $ref: '#/components/schemas/Amount' description: >- Trade fee charged to the requesting party (matching the `type` parameter — taker or maker), denominated in the `to` currency. createDate: $ref: '#/components/schemas/CreateDate' updateDate: $ref: '#/components/schemas/UpdateDate' quoteId: $ref: '#/components/schemas/Id' settlementTransactionHash: $ref: '#/components/schemas/SettlementTransactionHash' maturity: $ref: '#/components/schemas/Maturity' tenor: $ref: '#/components/schemas/Tenor' completeDate: $ref: '#/components/schemas/CompleteDate' TradeStatus: type: string enum: - pending - complete - confirmed - pending_settlement - taker_funded - maker_funded - refunded - breaching - breached Currency: type: string description: Currency code enum: - USDC - EURC Id: type: string format: uuid description: System-generated unique identifier of the resource. example: c4d1da72-111e-4d52-bdbf-2e74a2d803d5 ContractTradeId: type: string description: The ID of the trade on the contract. pattern: ^[0-9]+$ example: '24' Rate: type: number format: double description: Exchange rate for the quote example: 0.915 CurrencyAmount: type: object description: Currency and amount details for a foreign exchange transaction required: - currency properties: currency: $ref: '#/components/schemas/Currency' amount: $ref: '#/components/schemas/Amount' Amount: type: string pattern: ^\d+(?:\.\d{1,6})?$ description: Amount of currency, formatted as a string with up to six decimal places. example: '100.00' CreateDate: type: string format: date-time description: Date and time when the resource was created example: '2023-01-01T12:04:05Z' UpdateDate: type: string format: date-time description: Date and time when the resource was last updated example: '2023-01-01T12:04:05Z' SettlementTransactionHash: type: - string - 'null' description: The hash of the settlement transaction on-chain. pattern: ^0x[a-fA-F0-9]{64}$ example: '0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122' Maturity: type: - string - 'null' format: date-time description: The date when the trade has matured. example: '2023-01-01T12:04:05Z' Tenor: type: string description: The settlement schedule for the trade enum: - instant - hourly - daily CompleteDate: type: - string - 'null' format: date-time description: The time/date the trade was completed. example: '2023-01-01T12:04:05Z' securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: PREFIX:ID:SECRET description: >- Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are requred to make a successful request. ````