GET /tokenBalances

This endpoint retrieves token balances and corresponding prices for a given wallet address in the format required by the natural language endpoint.

This API is designed for developers and traders building programmatic or UI flows that leverage Haiku's natural language intent functionality accessible via the POST /buildIntentNaturalLanguage API. It supports the process of preparing data for use in constructing intents. Use this API to:

• Fetch wallet balances: Retrieve all token balances for a wallet in a pre-formatted structure.

• Prepare for natural language intents: Provide structured wallet data for the POST /buildIntentNaturalLanguage API, simplifying intent creation.

• Validate for quoting: Ensure the correct balances are used when preparing to quote a trade with the POST /quoteIntent API.

• Enable execution: Use this data to finalise and execute transactions via the POST /solveIntent API.

GET /tokenBalances

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

Parameter	Type	Description
address	string	The wallet address for which the token balances are to be fetched.

curl 'https://api.haiku.trade/v1/tokenBalances?address=0x3688055B0C9aDE5aE1b4145f6C746e6193067a6E' 

Returns a JSON object containing

Parameter	Type	Description
wallet_positions	object	Token balances, formatted for natural language intents
prices	object	Prices corresponding to each token in the wallet

{
  "wallet_positions": {
    "base:0x4158734d47fc9692176b5085e0f52ee0da5d47f1": 0.5166843500336669,
    "base:0x4200000000000000000000000000000000000006": 0.000002519875671558,
    "base:0x50c5725949a6f0c72e6c4a641f24049a917db0cb": 1.5084733275230073
  },
  "prices": {
    "base:0x4158734d47fc9692176b5085e0f52ee0da5d47f1": 1.6659677613197699,
    "base:0x4200000000000000000000000000000000000006": 2197.39,
    "base:0x50c5725949a6f0c72e6c4a641f24049a917db0cb": 1
  }
}