LiquidMesh API Access & Usage¶

This guide explains how to access and use LiquidMesh APIs securely and efficiently.

🔗 Public API Endpoints¶

You can call our public API endpoints with your API key.

Function	Endpoint
Quote	`https://api.liquidmesh.io/v1/{networkId}/quote`
Swap	`https://api.liquidmesh.io/v1/{networkId}/swap`
Order	`https://api.liquidmesh.io/v1/{networkId}/order`
Send Transaction	`https://api.liquidmesh.io/v1/{networkId}/send-transaction`

NetworkId:
Please reference Supported Chains

🔑 API Key¶

How to use¶

Add your API Key into the HTTP request header:

LM-API-KEY: <your-api-key>

How to apply¶

Request an API Key by contacting:
📧 support@liquidmesh.io

🔐 JWT Authentication¶

All current LiquidMesh gateways require JWT-signed requests. Pair every LM-API-KEY with an Ed25519-signed Bearer token as described in Using JWTs for LiquidMesh API Requests, which covers key generation, signing flow, and end-to-end request examples.

🛠 Example Request¶

Swap API (POST)

curl --location --request POST 'https://api.liquidmesh.io/v1/sui/swap' --header 'Content-Type: application/json' --header 'LM-API-KEY: 5261****c883' --data '{
    "userAddress": "0xdda7fc976f19a82abe4cad8fc9ef1d5c010daa699ccfbd8e4b13b389a8d9fec8",
    "slippageBps": 150,
    "swapInfo": {
        "chainId": "",
        "inputToken": "0xd0e89b2af5e4910726fbcd8b8dd37bb79b29e5f83f7491bca830e94f7f226d29::eth::ETH",
        "inputAmount": "10000000",
        "outputToken": "0xd1b72982e40348d069bb1ff701e634c117bb5f741f44dff91e472d3b01461e55::stsui::STSUI",
        "outputAmount": "84199640406",
        "priceImpactPct": "0.0478",
        "midPrice": "8843.013020697902902612",
        "routePlans": [
            {
                "amount": "10000000",
                "router": "...",
                "subRouters": [
                    {
                        "fromToken": "...",
                        "toToken": "...",
                        "dexes": [
                            {
                                "dex": "bluefin_spot",
                                "poolAddress": "...",
                                "weight": 10000,
                                "extraInfo": "{\"FeeRate\":1000,\"TickSpacing\":20}",
                                "reverse": true
                            }
                        ]
                    }
                ]
            }
        ],
        "blockNumber": 162973948,
        "estimatedGas": 176000
    },
    "showSimulateLogs": true
}'

🌐 IP Whitelisting¶

For security purposes, we recommend IP whitelisting.

Please provide your outbound IP addresses to support@liquidmesh.io.
Only whitelisted IPs will be able to make requests to restricted endpoints.

What is LiquidMesh