---
title: "POST /v2/external-matches/assemble-match-bundle"
method: POST
path: "/v2/external-matches/assemble-match-bundle"
tags: ["ExternalMatches"]
---

# POST /v2/external-matches/assemble-match-bundle

`POST /v2/external-matches/assemble-match-bundle`

## Request

- Base URL: `https://api.renegade.fi`
- URL: `https://api.renegade.fi/v2/external-matches/assemble-match-bundle`
- Auth: API key in header `X-Renegade-Auth`
- TypeScript: <https://skmtc.dev/renegade-fi/apis/renegade-v2-api/docs/v2/external-matches/assemble-match-bundle/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- AssembleExternalMatchRequest
  - `do_gas_estimation` boolean
  - `receiver_address` string
  - `assembly` union, required
    - object
      - `QuotedOrder` object, required
        - `signed_quote` ApiSignedQuote, required
          - `quote` ApiExternalQuote, required
            - `order` ExternalOrder, required
              - …
            - `match_result` ApiExternalMatchResult, required
              - …
            - `fees` FeeTake, required
              - …
            - `send` ApiExternalAssetTransfer, required
              - …
            - `receive` ApiExternalAssetTransfer, required
              - …
            - `price` ApiTimestampedPrice, required
              - …
            - `timestamp` integer, required
          - `signature` string, required
          - `deadline` integer, required
        - `updated_order` ExternalOrder
          - `input_mint` string, required
          - `output_mint` string, required
          - `input_amount` string, required
          - `output_amount` string, required
          - `use_exact_output_amount` boolean, required
          - `min_fill_size` string, required
    - object
      - `NewOrder` object, required
        - `external_order` ExternalOrder, required
          - `input_mint` string, required
          - `output_mint` string, required
          - `input_amount` string, required
          - `output_amount` string, required
          - `use_exact_output_amount` boolean, required
          - `min_fill_size` string, required

## Response `200`

Match bundle assembled successfully

- ExternalMatchResponse
  - `match_bundle` MalleableAtomicMatchApiBundle, required
    - `match_result` ApiBoundedMatchResult, required
      - `input_mint` string, required
      - `output_mint` string, required
      - `price_fp` string, required
      - `output_quoted_price_fp` string, required
      - `min_input_amount` string, required
      - `max_input_amount` string, required
    - `fee_rates` FeeTakeRate, required
      - `relayer_fee_rate` string, required
      - `protocol_fee_rate` string, required
    - `max_receive` ApiExternalAssetTransfer, required
      - `mint` string, required
      - `amount` string, required
    - `min_receive` ApiExternalAssetTransfer, required
      - `mint` string, required
      - `amount` string, required
    - `max_send` ApiExternalAssetTransfer, required
      - `mint` string, required
      - `amount` string, required
    - `min_send` ApiExternalAssetTransfer, required
      - `mint` string, required
      - `amount` string, required
    - `settlement_tx` TransactionRequest, required
      - `from` string
      - `to` string
      - `gas` string
      - `gasPrice` string
      - `value` string
      - `data` string
      - `nonce` string
      - `chainId` string
    - `deadline` integer, required
  - `gas_sponsorship_info` GasSponsorshipInfo
    - `refund_amount` integer, required
    - `refund_native_eth` boolean, required
    - `refund_address` string

## Changes

- **2026-07-17** `ff2b9f21f6b6`: 1 breaking
  - added the new required request property `assembly/oneOf[subschema #1]/QuotedOrder/signed_quote/quote/match_result/price_fp`
- **2026-01-10** `29b4c2d02987`: 1 warning
  - removed the request property `assembly/oneOf[subschema #1]/QuotedOrder/signed_quote/quote/match_result/price_fp`

[Operation history](https://skmtc.dev/renegade-fi/apis/renegade-v2-api/changes/v2/external-matches/assemble-match-bundle/post.md)

---

[API](https://skmtc.dev/renegade-fi/apis/renegade-v2-api.md) - [All operations](https://skmtc.dev/renegade-fi/apis/renegade-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/renegade-fi/apis/renegade-v2-api/revisions/ff2b9f21f6b6?raw)