POST /quoteIntent

This endpoint fetches detailed quote information about a trade with Haiku Intents. It provides insights into the proposed transaction, including resulting tokens and fees. This data is essential for populating UIs, understanding trade specifics, and ensuring all required allowances are provided for successful trade execution.

This API enables developers to gain a comprehensive preview of a proposed intent trade, ensuring all aspects of the transaction are understood and prepared for execution.

Developers and traders can use this API to:

• Preview trade details: Understand the tokens, fees, and trade outcomes before executing a transaction.

• Automate allowance handling: Programatically detect and prompt for required approvals, including Permit2 allowances.

• Enhance UI experiences: Populate UIs with comprehensive trade information for users, ensuring clarity and transparency.

• Generate actionable data: Prepare detailed transaction data for immediate execution via the POST /solveIntent endpoint.

POST /quoteIntent

Base URL: https://api.haiku.trade/v1

When preparing for a quote, ensure that the tokens involved are supported by first calling the GET /tokenList API. This ensures input and output tokens are valid.

Header

{
  "api-key": "<your-api-key>"
}

Body

{
  "intent": {
    "slippage": 0.003,                                           // 0.3% max slippage
    "receiver": "0xYourWalletAddress",
    "input_positions": {
      "arb:0xaf88d065e77c8cC2239327C5EDb3A432268e5831": 5       // $5 USDC(Arb)
    },
    "target_weights": {
      "arb:0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": 0.5,    // 50% USDT(Arb)
      "arb:0x82af49447d8a07e3bd95bd0d56f35241523fbab1": 0.5     // 50% WETH(Arb)
    }
  }
}

Parameter	Type	Description
slippage	number	Maximum allowed slippage (Must be in the range 0-0.01)
receiver	string	Address to receive the resulting tokens.
input_positions	object	Tokens provided for the swap with their respective amounts.
target_weights	object	Desired token weights after the swap (must sum to 1).

curl 'https://api.haiku.trade/v1/quoteIntent' \
-H 'Content-Type: application/json' \
-H 'api-key: <YOUR_API_KEY>' \
-d '{
    "intent": {
        "slippage": 0.01,
        "receiver": "0x3688055B0C9aDE5aE1b4145f6C746e6193067a6E",
        "input_positions": {
            "arb:0xaf88d065e77c8cC2239327C5EDb3A432268e5831": 5
        },
        "target_weights": {
            "arb:0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": 0.5,
            "arb:0x82af49447d8a07e3bd95bd0d56f35241523fbab1": 0.5
        }
    }
}'

Upon successfully retrieving a quote, use the data to finalise and execute the transaction via POST /solveIntent.

{
    "funds": [...],
    "fundfees": [...],
    "balances": [...],
    "outputTokenUsdPrices": [...],
    "approvals": [...],
    "permit2Datas": {...},
    "tokensReturn": [...]
}

Field	Type	Description
quoteId	string	Unique identifier for this quote
funds	array	List of tokens and amounts deducted for the trade.
fundfees	array	Fees charged for the trade, specified per token.
balances	array	Tokens and amounts that will be returned post-trade.
approvals	array	List of ERC-20 token approvals required for the transaction.
permit2Datas	object	Permit2 approval data if applicable.
isComplexBridge	bool	Flag representing if a post-bridge operation is required
destinationBridge	object	Post-bridge transaction data to sign if isComplexBridge
gas	object	Gas estimation data denominated in both gas token & USD

{
    "funds": [
        {
            "token": {
                "chainId": 42161,
                "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
                "decimals": 6,
                "symbol": "USDC",
                "name": "USD Coin"
            },
            "amount": "5"
        }
    ],
    "fundfees": [
        {
            "token": {
                "chainId": 42161,
                "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
                "decimals": 6,
                "symbol": "USDC",
                "name": "USD Coin"
            },
            "amount": "0"
        }
    ],
    "balances": [
        {
            "token": {
                "chainId": 42161,
                "address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
                "decimals": 6,
                "symbol": "USD₮0",
                "name": "USD₮0"
            },
            "amount": "2.494703"
        },
        {
            "token": {
                "chainId": 42161,
                "address": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
                "decimals": 18,
                "symbol": "WETH",
                "name": "Wrapped Ether"
            },
            "amount": "0.00128524281851051"
        }
    ],
    "approvals": [],
    "permit2Datas": {
        "domain": {
            "name": "Permit2",
            "chainId": 42161,
            "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
        },
        "types": {
            "PermitSingle": [
                {
                    "name": "details",
                    "type": "PermitDetails"
                },
                {
                    "name": "spender",
                    "type": "address"
                },
                {
                    "name": "sigDeadline",
                    "type": "uint256"
                }
            ],
            "PermitDetails": [
                {
                    "name": "token",
                    "type": "address"
                },
                {
                    "name": "amount",
                    "type": "uint160"
                },
                {
                    "name": "expiration",
                    "type": "uint48"
                },
                {
                    "name": "nonce",
                    "type": "uint48"
                }
            ]
        },
        "values": {
            "details": {
                "token": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
                "amount": {
                    "type": "BigNumber",
                    "hex": "0x4c4b40"
                },
                "expiration": 1742460201,
                "nonce": 16
            },
            "spender": "0x35147B7C6d2D94702643f101E3e62DE009020aED",
            "sigDeadline": 1742460200
        }
    },
    "isComplexBridge": false,
    "gas": {
        "amount": 287937,
        "usd": "0.00030085282435469761"
    }
}