> ## Documentation Index > Fetch the complete documentation index at: https://docs.zbx.boomfi.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Create Quick Trade > Request a quote and immediately accept it (or dry-run estimate) ## OpenAPI ````yaml /openapi.yaml post /trade/quicktrade openapi: 3.1.0 info: contact: email: support@boomfi.xyz name: API Support description: >- The BoomFi Merchants API provides a set of endpoints for merchants to manage their accounts, transactions, and more. Hosts differ per brand/environment; use the brand-specific base URL from the docs. title: ZBX Merchants API version: '1.0' servers: - url: https://mapi.zbx.boomfi.xyz/v1 description: Production security: [] tags: - description: Payment links name: Paylinks - description: Billing plans name: Plans - description: Subscriptions name: Subscriptions - description: Customer records name: Customers - description: Invoices name: Invoices - description: Payments name: Payments - description: Organisation events name: Events - description: Organisation profile and display settings name: Organisation - description: Webhook and request-signing secrets name: Secrets - description: Settlement accounts name: Accounts - name: Bank Address Book - description: Managed virtual accounts, balances, pay-in, and payout name: Virtual Accounts - description: Partner-managed accounts, virtual accounts, pay-in, and payout name: Partners - description: Partner virtual account automations and run history name: Partner Automations - description: Partner maintain-balance automations name: Partner Balance Monitoring - description: Tradeable currencies, instruments, and swap targets name: Instruments - description: RFQ quotes name: Quotes - description: RFQ orders and one-click trades name: Orders - description: Executed trades name: Trades paths: /trade/quicktrade: post: tags: - Orders summary: Create Quick Trade description: Request a quote and immediately accept it (or dry-run estimate) requestBody: content: application/json: schema: $ref: '#/components/schemas/trade.QuickTradeRequest' description: Quick trade request required: true responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/internal.Response-trade_QuickTradeResponse '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' security: - ApiKeyAuth: [] components: schemas: trade.QuickTradeRequest: properties: account_id: description: Settlement account ID override for the source balance. example: 42 type: integer account_reference: description: Virtual account reference override (defaults to the org primary VA). type: string amount: description: Source amount to sell/swap. example: '100' type: string chain_id: description: Source chain ID. example: 8453 type: integer currency: description: Source currency symbol. example: USDC type: string dry_run: description: When true, return a quote estimate only and do not accept/execute. example: false type: boolean reference: description: Optional client reference stored on the order. type: string settlement_account_id: description: Settlement account ID. Mutually exclusive with settlement_address. example: 42 type: integer settlement_address: description: >- External settlement wallet address. Mutually exclusive with settlement_account_id. type: string to_chain_id: description: Destination chain ID. example: 1 type: integer to_currency: description: Destination currency symbol. example: ETH type: string required: - amount - currency - to_currency type: object internal.Response-trade_QuickTradeResponse: properties: data: allOf: - $ref: '#/components/schemas/trade.QuickTradeResponse' description: Response payload when the request succeeded. error: description: True when the request failed. type: boolean message: description: Human-readable status or error message. type: string type: object internal.ErrorResponse: properties: error: allOf: - $ref: '#/components/schemas/internal.ErrorStruct' description: Error details including HTTP-style code and message. type: object trade.QuickTradeResponse: properties: account_id: description: Unique identifier of the account this resource belongs to. type: integer created_at: description: When the resource was created (RFC3339). type: string deposit_instruction: additionalProperties: {} description: Instructions for depositing trade input assets. type: object effective_rate: description: Effective rate after fees. type: string fees: additionalProperties: type: number description: Fee breakdown for this quote or trade. type: object from_amount: description: Amount of the sell asset. type: string from_chain_id: description: Source blockchain chain ID. type: integer from_currency: description: Source currency code. type: string order_id: description: Unique order identifier this trade or fill belongs to. type: string quote_id: description: Unique RFQ quote identifier for this order or trade. type: string reference: description: Merchant-defined reference string. type: string settlement_instruction: additionalProperties: {} description: Instructions for receiving settlement proceeds. type: object side: allOf: - $ref: '#/components/schemas/docenums.OrderSide' description: Trade side. status: allOf: - $ref: '#/components/schemas/docenums.RfqOrderStatus' description: Status of this resource. to_amount: description: Amount of the buy asset. type: string to_chain_id: description: Destination blockchain chain ID. type: integer to_currency: description: Destination currency code. type: string type: object internal.ErrorStruct: properties: code: description: |- Error code Example: 400 example: 400 type: integer errors: description: List of errors items: $ref: '#/components/schemas/internal.SingleError' type: array message: description: |- Error message Example: Insufficient quantity example: Insufficient quantity type: string type: object docenums.OrderSide: enum: - Buy - Sell type: string x-enum-varnames: - OrderSideBuy - OrderSideSell docenums.RfqOrderStatus: enum: - Open - Rejected - Closed type: string x-enum-varnames: - RfqOrderStatusOpen - RfqOrderStatusRejected - RfqOrderStatusClosed internal.SingleError: properties: domain: description: |- Domain Example: orders example: orders type: string reason: description: |- Error Reason Example: InsufficientQuantity example: InsufficientQuantity type: string type: object securitySchemes: ApiKeyAuth: in: header name: X-API-KEY type: apiKey ````