> ## Documentation Index > Fetch the complete documentation index at: https://docs.0xmonaco.com/llms.txt > Use this file to discover all available pages before exploring further. # Trade Feed > Trade Feed Trades across every market, newest first, from the full history (recent and archived trades alike). Set `taker_application_id` to list only the trades an application (frontend) took. Public; each client IP has a read budget, and a request over it gets HTTP 429 / RESOURCE_EXHAUSTED. ## OpenAPI ````yaml /proto-openapi/api/openapi.yaml get /api/v1/trades openapi: 3.0.3 info: title: Monaco Protocol API description: REST API for the Monaco Protocol hybrid CLOB exchange. version: 1.0.0 servers: - url: https://apimonaco.xyz description: Production (Sei mainnet) security: [] tags: - name: AccountsService - name: AnalyticsService - name: ApplicationsService - name: AuthService - name: BuildercodeRewardsService - name: ComplianceService - name: CopyTradingService - name: DelegatedAgentsService - name: FaucetService - name: FeesService - name: HealthService - name: ManagedMarketsService description: |- Wallet-authenticated maker assignments. The signed session must match both configured maker user and application. Owner IDs are process fences, never auth. Only wallet sessions are supported; delegated-agent sessions receive 403. - name: MarginAccountsService description: |- Current public isolated-margin semantics: - a user has one parent margin account per application scope - opening orders create or reuse isolated position buckets under that parent - parent account creation is handled internally by margin workflows - name: MarketService - name: OrderbookService - name: OrdersService - name: PositionsService description: |- Current public isolated-margin semantics: - positions link to a parent margin account and, when applicable, a bucket id - opening orders create or reuse isolated position buckets under the parent - users can open another isolated position by reusing the parent account with a different market bucket - name: PulseService - name: RfqService - name: SweeperService - name: TraderCodeService - name: TradesService - name: WithdrawalsService paths: /api/v1/trades: get: tags: - TradesService - Trades summary: Trade Feed description: |- Trade Feed Trades across every market, newest first, from the full history (recent and archived trades alike). Set `taker_application_id` to list only the trades an application (frontend) took. Public; each client IP has a read budget, and a request over it gets HTTP 429 / RESOURCE_EXHAUSTED. operationId: list_trades parameters: - name: takerApplicationId in: query schema: type: string - name: pageSize in: query schema: type: integer format: uint32 minimum: 1 maximum: 1000 default: 25 description: Max trades to return (max 1000) - name: pageToken in: query description: |- Pagination cursor with two states: - Omitted or empty string (""): start from the most recent trade. - Non-empty: an opaque cursor from a previous response's `next_page_token`; results resume immediately after that position. The walk is a keyset seek on `(executed_at, id)`, both immutable once a trade is written, so a page neither repeats nor skips a trade when new fills land mid-walk. `taker_application_id` is pinned inside the token, so a token is rejected if the filter changes. schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ListTradesResponse' '400': description: Invalid filter, page size or page token '429': description: Public read rate limit exceeded for this client '500': description: Internal server error components: schemas: ListTradesResponse: type: object properties: trades: type: array items: $ref: '#/components/schemas/PublicTrade' nullable: true pageSize: example: 25 type: integer description: Maximum number of trades returned format: uint32 nullable: true nextPageToken: type: string description: >- Cursor for the next page. The read fetches one row past `page_size`, so an empty token means the walk is finished and a non-empty token means a further trade exists. Recent and archived trades are read in one statement, so a client can stop on the empty token without a confirming request. nullable: true description: One page of the trade feed, newest first. PublicTrade: type: object properties: data: $ref: '#/components/schemas/TradeData' eventType: example: trade type: string description: Event type identifier nullable: true tradingPairId: example: 456e7890-e12b-12d3-a456-426614174000 type: string description: Trading pair UUID format: uuid nullable: true tradingMode: example: SPOT type: string description: 'Trading mode: SPOT or MARGIN' nullable: true description: >- A public trade event. Serializes to the REST envelope: { data: { ... }, eventType, tradingPairId, tradingMode }. The WebSocket surface emits the equivalent envelope with snake_case keys. TradeData: type: object properties: executedAt: example: '2023-11-13T10:30:00Z' type: string description: >- Trade execution timestamp (ISO 8601). Omitted when the trade has no execution time. nullable: true makerSide: example: BUY type: string description: 'Maker order side: BUY or SELL' nullable: true price: example: '35000.00' type: string description: Execution price nullable: true quantity: example: '0.5' type: string description: Traded quantity in base token (normalized) nullable: true quantityRaw: example: '50000000' type: string description: Traded quantity in raw base-token units nullable: true tradeId: example: 123e4567-e89b-12d3-a456-426614174000 type: string description: Trade UUID format: uuid nullable: true executionSource: example: CLOB type: string description: >- How the trade executed: CLOB (on the order book) or RFQ (a request-for-quote block fill). nullable: true makerAddress: example: '0x1234567890abcdef1234567890abcdef12345678' type: string description: Wallet address of the maker nullable: true takerAddress: example: '0xabcdef1234567890abcdef1234567890abcdef12' type: string description: Wallet address of the taker nullable: true takerFeeRaw: example: '8750' type: string description: >- Monaco's taker fee on the trade, in raw quote-asset units (the asset's smallest unit). Excludes the frontend's builder fee. Omitted when the trade recorded none. nullable: true quoteVolumeRaw: example: '17500000000' type: string description: >- Executed notional (price times quantity), in raw quote-asset units (the asset's smallest unit). Omitted when the trade recorded none. nullable: true takerApplicationId: example: 789e0123-e45b-12d3-a456-426614174000 type: string description: >- Application (frontend) that placed the taker order. A trade's volume and fees are attributed to it. Omitted when unknown. format: uuid nullable: true builderFeeRaw: example: '4375' type: string description: >- The taker's builder fee: the add-on the taker's application (frontend) charged on the trade, in raw quote-asset units (the asset's smallest unit), on top of takerFeeRaw. "0" when it charged none. nullable: true description: >- Core fields of a single executed trade, nested under `data` in the public trade event envelope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.