BLblockdaemon
dex

Fill Order

Facilitates the execution (“filling”) of an existing limit order on a decentralized exchange by specifying the order ID, taker address, and offered token amount. The endpoint returns transaction data (chain ID, addresses, gas details, etc.) and a reference ID, enabling secure settlement of trades while providing a clear audit trail.

💡 Compute Unit Value: 25 (Fixed)

post/defi/v1/dex/fillorder

Request

  • Base URL
    https://svc.blockdaemon.com
  • URL
    https://svc.blockdaemon.com/defi/v1/dex/fillorder
  • Auth
    API key in header X-API-Key

Request body

dexId'2200' | '2201' | '2202' | '2203' | '2204' | '2205' | '2206'

The unique ID to specify the decentralized exchange (DEX) within a particular blockchain. Find more here.

orderIdstring[] required

The ID of the limit order to be filled.

fromstring required

The wallet address of the Taker that will receive the Maker asset.

amountInstring required

Amount of the input token to provide, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: to swap 1 WETH (18 decimals), use "1000000000000000000"; to swap 1 USDC (6 decimals), use "1000000".

gasstring

Maximum number of gas units to allocate for the transaction, as an integer string (e.g., '200000'). If omitted, gas is estimated automatically. Note: this is gas units, not wei or gwei.

gasPrioritystring

Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

enableFeeboolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

Example request

{
  "dexId": "2200",
  "orderId": [
    "95167"
  ],
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "amountIn": "1000000000000000000",
  "gas": "100000",
  "gasPriority": "low",
  "enableFee": false
}

Response

Successful response

statusinteger
msgstring
dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "137",
    "from": "0x42a0eef97019bf6f15796fc9a015f681c581f77a",
    "to": "0xcab2FA2eeab7065B45CBcF6E3936dDE2506b4f6C",
    "value": "0",
    "data": "0xd2f1d95600000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002386f26fc100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000669cdcb000000000000000000000000042a0eef97019bf6f15796fc9a015f681c581f77a000000000000000000000000000000000000000000000000000000000000074000000000000000000000000000000000fbdccc06511746daa8d2280e6d33a21f0000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000c2132d05d31c914a87c6611c10748aeb04b58e8f000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b402000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000de0b6b3a7640000000000000000000000000000000000000000000000000000000000000007a1200000000000000000000000644f82e73edb06d29ff62c91ec8f5ff06571bdeb2900000000000000000000000000000000000000000000000000000000000001e00000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000003200000000000000000000000000000000000000000000000000000000000000540000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044f4a215c30000000000000000000000000000000000000000000000000de0b6b3a7640000000000000000000000000000000000000000000000000000000000000007a120000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044296637bf0000000000000000000000000000000000000000000000000de0b6b3a7640000000000000000000000000000000000000000000000000000000000000007a1200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001e4961d5b1e000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000002000000000000000000000000cab2fa2eeab7065b45cbcf6e3936dde2506b4f6c000000000000000000000000cab2fa2eeab7065b45cbcf6e3936dde2506b4f6c0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000044cf6fc6e3000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b402000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002463592c2b000000000000000000000000000000000000000000000000000000006c8b6e2a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000419aa918d0001e995fc1b2f4302fcadd64b702ca9802962ac437298b4a6c159ea7260d809a76e5718bb4bc84bcf80baed6299bfada2e839a70c7d6ac18090af2ea1c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041d7c56c4419dc47b359f8a3e006c212ad313e2b4c5a902c24225743514f0e85f44a52beaca4c0329a78047c231cced261ab834efab6cb90b84244ef7105e0d0771c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "gasPrice": "30000000029",
    "referenceId": "8a095c21d72b411ba742ab546042f716"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.