Turbine

Turbine API endpoints

Submit a new liquidity request to the system

post

Body

Represents a liquidity addition with SignatureTransfer permit functionality.

This struct encapsulates all necessary information needed to submit a new intent to add liquidity to the system, including the intent and SignatureTransfer permit data for approvals. User authentication is handled via session-based SIWE verification.

Fields

add_liquidity The intent to add liquidity
permit_tokens The batch SignatureTransfer permit and signature for token0 and token1

Responses

200

Liquidity intent successfully submitted

application/json

Response returned after successfully submitting a liquidity intent to the system. Contains the unique identifier assigned to the submitted intent.

Fields

hash - Unique identifier assigned to the liquidity intent

intentHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid intent, signatures, or session state

application/json

401

User not authorized

application/json

500

Internal server error

application/json

post/api/add_liquidity

POST /api/add_liquidity HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 720

{
  "addLiquidity": {
    "exact": false,
    "fee": "3000",
    "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
    "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
    "token0": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "token0Amount": "1000000000000000000",
    "token1": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "token1Amount": "1000000000000000000"
  },
  "permitTokens": {
    "permit": {
      "deadline": "1630003600",
      "nonce": "0",
      "permitted": [
        {
          "amount": "1000000000000000000",
          "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        }
      ]
    },
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    }
  }
}

{
  "intentHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Submit a new order to the system

post

Body

Represents an order submission with optional permit functionality.

This struct encapsulates all necessary information needed to submit a new order to the system. signed_permit is required only for non-smart orders.

Responses

200

Order successfully submitted

application/json

Response returned after successfully submitting an order to the system. Contains the unique identifier assigned to the submitted order.

Fields

order_hash - Unique identifier assigned to the submitted order

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid order, signature, or session state

application/json

401

User not authorized

application/json

500

Internal server error

application/json

503

Orderbook is full

application/json

post/api/add_order

POST /api/add_order HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 656

{
  "annotations": {
    "spreadAtSubmissionHbp": null
  },
  "order": {
    "buyToken": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "callData": "0x",
    "callDataTarget": "0x0000000000000000000000000000000000000000",
    "calldataBuyAmountOffset": "36",
    "calldataSellAmountOffset": "4",
    "endTime": "1630003600",
    "minBuyAmount": "950",
    "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
    "partialFill": true,
    "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
    "sellAmount": "1000",
    "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "spreadCurve": {
      "endDeltaBps": 1,
      "points": [
        {
          "deltaBps": 1,
          "windowBps": 1
        }
      ],
      "startDeltaBps": 1
    },
    "startTime": "1630000000"
  },
  "signedPermit": null
}

{
  "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Submit multiple orders to the system

post

Bodyobject · AddOrder[]

Represents an order submission with optional permit functionality.

This struct encapsulates all necessary information needed to submit a new order to the system. signed_permit is required only for non-smart orders.

Responses

200

Orders successfully submitted

application/json

Response returned after successfully submitting an order to the system. Contains the unique identifier assigned to the submitted order.

Fields

order_hash - Unique identifier assigned to the submitted order

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid orders, signatures, or session state

application/json

401

User not authorized

application/json

500

Internal server error

application/json

503

Orderbook is full

application/json

post/api/add_orders

POST /api/add_orders HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 658

[
  {
    "annotations": {
      "spreadAtSubmissionHbp": null
    },
    "order": {
      "buyToken": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "callData": "0x",
      "callDataTarget": "0x0000000000000000000000000000000000000000",
      "calldataBuyAmountOffset": "36",
      "calldataSellAmountOffset": "4",
      "endTime": "1630003600",
      "minBuyAmount": "950",
      "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
      "partialFill": true,
      "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
      "sellAmount": "1000",
      "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "spreadCurve": {
        "endDeltaBps": 1,
        "points": [
          {
            "deltaBps": 1,
            "windowBps": 1
          }
        ],
        "startDeltaBps": 1
      },
      "startTime": "1630000000"
    },
    "signedPermit": null
  }
]

[
  {
    "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
  }
]

Remove an order from the system

post

Body

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

Responses

200

Order successfully queued for cancellation

application/json

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

401

User not authorized

application/json

404

Order not found or not owned by caller

application/json

500

Internal server error

application/json

post/api/cancel_order

POST /api/cancel_order HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

{
  "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Get the current config

get

Responses

200

Config retrieved successfully

application/json

lpHookAddressstring · addressRequiredExample: 0x1234567890123456789012345678901234567890

lpRouterAddressstring · addressRequiredExample: 0x1234567890123456789012345678901234567890

maxSignatureLifetimeSinteger · int64Required

Maximum allowed remaining validity of an EIP-712 auth signature, in seconds.

minLiquidityVolumeUsdcstring · uint256Required

Minimum total USDC volume for a liquidity provision intent, in native USDC units (6 decimals). A value of 10000000 is 10 USDC.

Example: 10000000

minTradeSizeUsdcstring · uint256Required

Minimum trade size in native USDC units (6 decimals). A value of 10000000 is 10 USDC.

Example: 10000000

poolManagerAddressstring · addressRequiredExample: 0x1234567890123456789012345678901234567890

siweDomainstringRequiredExample: dev-swap.propellerheads.xyz

siweUristringRequiredExample: https://dev-turbine.propellerheads.xyz/api

submitSettlementsbooleanRequired

turbineSettlerAddressstring · addressRequiredExample: 0x1234567890123456789012345678901234567890

turbineSignerAddressstring · addressRequiredExample: 0x1234567890123456789012345678901234567890

versionstringRequiredExample: 0.109.1

get/api/config

GET /api/config HTTP/1.1
Accept: */*

200

Config retrieved successfully

{
  "eip712Domain": {
    "chainId": 1,
    "name": "Turbine",
    "salt": "0x1234567890123456789012345678901234567890123456789012345678901234",
    "verifyingContract": "0x1234567890123456789012345678901234567890",
    "version": "1"
  },
  "lpHookAddress": "0x1234567890123456789012345678901234567890",
  "lpRouterAddress": "0x1234567890123456789012345678901234567890",
  "maxSignatureLifetimeS": 1,
  "minLiquidityVolumeUsdc": "10000000",
  "minTradeSizeUsdc": "10000000",
  "poolManagerAddress": "0x1234567890123456789012345678901234567890",
  "siweDomain": "dev-swap.propellerheads.xyz",
  "siweUri": "https://dev-turbine.propellerheads.xyz/api",
  "submitSettlements": true,
  "tokens": [
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "class": null,
      "decimals": 1,
      "oracles": {
        "ANY_ADDITIONAL_PROPERTY": {
          "ticker_symbol": "text"
        }
      },
      "symbol": "text"
    }
  ],
  "turbineSettlerAddress": "0x1234567890123456789012345678901234567890",
  "turbineSignerAddress": "0x1234567890123456789012345678901234567890",
  "version": "0.109.1"
}

Submit an EIP-712 signed liquidity deposit intent

post

Body

EIP-712 request body: the semantic payload plus its auth block. The EIP-712 signature covers the payload's typed struct together with nonce and deadline.

Responses

200

Liquidity intent successfully submitted

application/json

Response returned after successfully submitting a liquidity intent to the system. Contains the unique identifier assigned to the submitted intent.

Fields

hash - Unique identifier assigned to the liquidity intent

intentHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid intent, deadline, or pool

application/json

401

Invalid signature or signer mismatch

application/json

409

Nonce already used or reserved

application/json

post/api/eip712/add_liquidity

POST /api/eip712/add_liquidity HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1041

{
  "auth": {
    "deadline": 1760000600,
    "nonce": "8421337650123",
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    },
    "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
  },
  "payload": {
    "addLiquidity": {
      "exact": false,
      "fee": "3000",
      "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
      "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
      "token0": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "token0Amount": "1000000000000000000",
      "token1": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "token1Amount": "1000000000000000000"
    },
    "permitTokens": {
      "permit": {
        "deadline": "1630003600",
        "nonce": "0",
        "permitted": [
          {
            "amount": "1000000000000000000",
            "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
          }
        ]
      },
      "signature": {
        "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
        "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
        "yParity": "false"
      }
    }
  }
}

{
  "intentHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Submit a single EIP-712 signed order

post

Body

EIP-712 request body: the semantic payload plus its auth block. The EIP-712 signature covers the payload's typed struct together with nonce and deadline.

Responses

200

Order successfully submitted

application/json

Response returned after successfully submitting an order to the system. Contains the unique identifier assigned to the submitted order.

Fields

order_hash - Unique identifier assigned to the submitted order

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid order, deadline, or canonicalization

application/json

401

Invalid signature or signer mismatch

application/json

409

Nonce already used or reserved

application/json

503

Orderbook is full

application/json

post/api/eip712/add_order

POST /api/eip712/add_order HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 915

{
  "auth": {
    "deadline": 1760000600,
    "nonce": "8421337650123",
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    },
    "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
  },
  "payload": {
    "annotations": {
      "spreadAtSubmissionHbp": null
    },
    "order": {
      "buyToken": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "callData": "0x",
      "callDataTarget": "0x0000000000000000000000000000000000000000",
      "endTime": "1630003600",
      "minBuyAmount": "950",
      "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
      "partialFill": true,
      "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
      "sellAmount": "1000",
      "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "startTime": "1630000000"
    },
    "signedPermit": null,
    "spreadCurve": {
      "endDeltaBps": 1,
      "points": [
        {
          "deltaBps": 1,
          "windowBps": 1
        }
      ],
      "startDeltaBps": 1
    }
  }
}

{
  "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Submit multiple independently-signed orders

post

Bodyobject · Eip712RequestBody_AddOrderEip712[]

A batch of independently signed add-order requests.

Responses

200

Orders successfully submitted

application/json

Response returned after successfully submitting an order to the system. Contains the unique identifier assigned to the submitted order.

Fields

order_hash - Unique identifier assigned to the submitted order

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

All envelopes invalid (per-element errors inside)

application/json

503

Orderbook is full

application/json

post/api/eip712/add_orders

POST /api/eip712/add_orders HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 917

[
  {
    "auth": {
      "deadline": 1760000600,
      "nonce": "8421337650123",
      "signature": {
        "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
        "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
        "yParity": "false"
      },
      "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
    },
    "payload": {
      "annotations": {
        "spreadAtSubmissionHbp": null
      },
      "order": {
        "buyToken": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "callData": "0x",
        "callDataTarget": "0x0000000000000000000000000000000000000000",
        "endTime": "1630003600",
        "minBuyAmount": "950",
        "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
        "partialFill": true,
        "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
        "sellAmount": "1000",
        "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "startTime": "1630000000"
      },
      "signedPermit": null,
      "spreadCurve": {
        "endDeltaBps": 1,
        "points": [
          {
            "deltaBps": 1,
            "windowBps": 1
          }
        ],
        "startDeltaBps": 1
      }
    }
  }
]

[
  {
    "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
  }
]

Cancel an order with an EIP-712 signed request

post

Body

EIP-712 request body: the semantic payload plus its auth block. The EIP-712 signature covers the payload's typed struct together with nonce and deadline.

Responses

200

Order successfully queued for cancellation

application/json

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

404

Order not found or not owned by the signer

application/json

409

Nonce already used or reserved

application/json

post/api/eip712/cancel_order

POST /api/eip712/cancel_order HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 403

{
  "auth": {
    "deadline": 1760000600,
    "nonce": "8421337650123",
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    },
    "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
  },
  "payload": {
    "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
  }
}

{
  "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Query the signer's liquidity intents by hash

post

Body

EIP-712 request body: the semantic payload plus its auth block. The EIP-712 signature covers the payload's typed struct together with nonce and deadline.

Responses

200

Liquidity intent states owned by the recovered signer

application/json

hashstring · bytes32Required

intentobjectRequired

statusstring · enumRequiredPossible values:

400

Invalid deadline, or an empty or oversized hash list

application/json

401

Invalid signature or signer mismatch

application/json

post/api/eip712/liquidity_intents

POST /api/eip712/liquidity_intents HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 340

{
  "auth": {
    "deadline": 1760000600,
    "nonce": "8421337650123",
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    },
    "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
  },
  "payload": {
    "hashes": [
      "text"
    ]
  }
}

[
  {
    "hash": "text",
    "intent": {},
    "status": "Pending"
  }
]

Query the signer's orders

post

Body

EIP-712 request body: the semantic payload plus its auth block. The EIP-712 signature covers the payload's typed struct together with nonce and deadline.

Responses

200

Orders for the recovered signer

application/json

Response body for GET /api/orders.

cursorstring · nullableOptional

Opaque token to pass back as cursor in the next request. null on the last page.

hasMorebooleanRequired

Mirrors cursor.is_some().

400

Invalid deadline or query

application/json

401

Invalid signature or signer mismatch

application/json

post/api/eip712/orders

POST /api/eip712/orders HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 388

{
  "auth": {
    "deadline": 1760000600,
    "nonce": "8421337650123",
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    },
    "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
  },
  "payload": {
    "cursor": "text",
    "hashes": [
      "text"
    ],
    "limit": 1,
    "statuses": [
      "Active"
    ]
  }
}

{
  "cursor": null,
  "hasMore": true,
  "orders": [
    {
      "execution": [
        {
          "batchId": null,
          "blockNumber": 1,
          "boughtAmount": "text",
          "midPrice": {},
          "soldAmount": "text",
          "surplusBuyAmount": "text",
          "txHash": null
        }
      ],
      "hash": "text",
      "orderDetails": {
        "annotations": {
          "spreadAtSubmissionHbp": null
        },
        "buyToken": "text",
        "createdTimestamp": "2026-08-12T00:01:44.991Z",
        "endTime": "text",
        "limitPrice": {},
        "sellAmount": "text",
        "sellToken": "text",
        "spreadCurve": {
          "endDeltaBps": 1,
          "endSecs": 1,
          "points": [
            {
              "deltaBps": 1,
              "timeSecs": 1
            }
          ],
          "startDeltaBps": 1,
          "startSecs": 1
        },
        "startTime": "text"
      },
      "owner": "text",
      "status": "Active"
    }
  ]
}

Submit an EIP-712 signed liquidity withdrawal intent

post

Body

EIP-712 request body: the semantic payload plus its auth block. The EIP-712 signature covers the payload's typed struct together with nonce and deadline.

Responses

200

Liquidity intent successfully submitted

application/json

Response returned after successfully submitting an intent to the system. Contains the unique identifier assigned to the submitted intent.

Fields

hash - Unique identifier assigned to the submitted intent

intentHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid intent, deadline, or pool

application/json

401

Invalid signature or signer mismatch

application/json

409

Nonce already used or reserved

application/json

post/api/eip712/remove_liquidity

POST /api/eip712/remove_liquidity HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1048

{
  "auth": {
    "deadline": 1760000600,
    "nonce": "8421337650123",
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    },
    "signer": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0"
  },
  "payload": {
    "permitLpToken": {
      "permit": {
        "deadline": "1630003600",
        "nonce": "0",
        "permitted": {
          "amount": "1000000000000000000",
          "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        }
      },
      "signature": {
        "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
        "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
        "yParity": "false"
      }
    },
    "removeLiquidity": {
      "fee": "3000",
      "lpToken": "0x0000000000000000000000000000000000000000",
      "lpTokenAmount": "1000000000000000000",
      "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
      "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
      "token0": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "token1": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
    }
  }
}

{
  "intentHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Get statuses for multiple liquidity intents

post

Body

intentHashesstring · bytes32[]RequiredExample: ["0x1234567890123456789012345678901234567890123456789012345678901234"]

Responses

200

Liquidity intent states retrieved successfully

application/json

hashstring · bytes32Required

intentobjectRequired

statusstring · enumRequiredPossible values:

401

User not authorized

application/json

post/api/liquidity_intent_states

POST /api/liquidity_intent_states HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "intentHashes": "[\"0x1234567890123456789012345678901234567890123456789012345678901234\"]"
}

[
  {
    "hash": "text",
    "intent": {},
    "status": "Pending"
  }
]

Logout and clear all sessions for the current user

post

Responses

200

Successfully logged out, all sessions cleared

No content

400

Invalid session state

application/json

401

User not authorized

application/json

500

Internal server error

application/json

post/api/logout

POST /api/logout HTTP/1.1
Accept: */*

No content

Get current user session information

get

Responses

200

User session information retrieved successfully

application/json

addressstring · addressRequired

authenticatedbooleanRequired

400

Invalid session state

application/json

401

User not authorized

application/json

500

Internal server error

application/json

get/api/me

GET /api/me HTTP/1.1
Accept: */*

{
  "address": "text",
  "authenticated": true
}

Generate a nonce for the SIWE flow.

post

Responses

200

Nonce generated successfully

text/plain

stringOptional

400

Cannot generate nonce: user is already authenticated or nonce already exists

application/json

500

Internal server error

application/json

post/api/nonce

POST /api/nonce HTTP/1.1
Accept: */*

text

post

Body

The swap intent for a user

buyTokenstring · addressRequired

The token being bought

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

callDatastring · bytesRequired

Optional call data for smart orders, allowing custom routing

Example: 0x

callDataTargetstring · addressRequired

The address of the target contract for the calldata

Example: 0x0000000000000000000000000000000000000000

calldataBuyAmountOffsetinteger · uint64Required

The offset of the buy amount in the calldata If Some, used to update the calldata with the actual buy amount

Example: 36

calldataSellAmountOffsetinteger · uint64Required

The offset of the sell amount in the calldata If Some, used to update the calldata with the actual sell amount

Example: 4

endTimeinteger · uint256Required

Block timestamp until when the order is valid.

Example: 1630003600

minBuyAmountstring · uint256Required

The minimum amount of tokens being bought, effectively defining limit price.

Example: 950

ownerstring · addressRequired

The address of the user submitting the order

Example: 0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0

partialFillboolean · booleanRequired

Flag allowing partial fills

Example: true

saltstring · bytes32Required

The offset of the buy amount in the calldata Used to differentiate between orders with the same parameters

Example: 0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1

sellAmountstring · uint196Required

The amount of tokens being sold

Example: 1000

sellTokenstring · addressRequired

The token being sold

Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

startTimeinteger · uint256Required

Block timestamp since when the order is valid

Example: 1630000000

Responses

200

Order fees retrieved successfully

text/plain

stringOptional

400

Invalid request

application/json

500

Internal server error

application/json

post/api/order_fees

POST /api/order_fees HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 581

{
  "buyToken": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
  "callData": "0x",
  "callDataTarget": "0x0000000000000000000000000000000000000000",
  "calldataBuyAmountOffset": "36",
  "calldataSellAmountOffset": "4",
  "endTime": "1630003600",
  "minBuyAmount": "950",
  "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
  "partialFill": true,
  "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
  "sellAmount": "1000",
  "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "spreadCurve": {
    "endDeltaBps": 1,
    "points": [
      {
        "deltaBps": 1,
        "windowBps": 1
      }
    ],
    "startDeltaBps": 1
  },
  "startTime": "1630000000"
}

text

get

Body

orderHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

Responses

200

Order state retrieved successfully

application/json

hashstring · bytes32Required

ownerstring · addressRequired

statusstring · enumRequiredPossible values:

401

User not authorized

application/json

404

Order not found or not owned by caller

application/json

500

Internal server error

application/json

get/api/order_state

GET /api/order_state HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "orderHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

{
  "execution": [
    {
      "batchId": null,
      "blockNumber": 1,
      "boughtAmount": "text",
      "midPrice": {},
      "soldAmount": "text",
      "surplusBuyAmount": "text",
      "txHash": null
    }
  ],
  "hash": "text",
  "orderDetails": {
    "annotations": {
      "spreadAtSubmissionHbp": null
    },
    "buyToken": "text",
    "createdTimestamp": "2026-08-12T00:01:44.991Z",
    "endTime": "text",
    "limitPrice": {},
    "sellAmount": "text",
    "sellToken": "text",
    "spreadCurve": {
      "endDeltaBps": 1,
      "endSecs": 1,
      "points": [
        {
          "deltaBps": 1,
          "timeSecs": 1
        }
      ],
      "startDeltaBps": 1,
      "startSecs": 1
    },
    "startTime": "text"
  },
  "owner": "text",
  "status": "Active"
}

Get states for multiple orders

post

Body

orderHashesstring · bytes32[]RequiredExample: ["0x1234567890123456789012345678901234567890123456789012345678901234"]

Responses

200

Order states retrieved successfully

application/json

hashstring · bytes32Required

ownerstring · addressRequired

statusstring · enumRequiredPossible values:

401

User not authorized

application/json

post/api/order_states

POST /api/order_states HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "orderHashes": "[\"0x1234567890123456789012345678901234567890123456789012345678901234\"]"
}

[
  {
    "execution": [
      {
        "batchId": null,
        "blockNumber": 1,
        "boughtAmount": "text",
        "midPrice": {},
        "soldAmount": "text",
        "surplusBuyAmount": "text",
        "txHash": null
      }
    ],
    "hash": "text",
    "orderDetails": {
      "annotations": {
        "spreadAtSubmissionHbp": null
      },
      "buyToken": "text",
      "createdTimestamp": "2026-08-12T00:01:44.991Z",
      "endTime": "text",
      "limitPrice": {},
      "sellAmount": "text",
      "sellToken": "text",
      "spreadCurve": {
        "endDeltaBps": 1,
        "endSecs": 1,
        "points": [
          {
            "deltaBps": 1,
            "timeSecs": 1
          }
        ],
        "startDeltaBps": 1,
        "startSecs": 1
      },
      "startTime": "text"
    },
    "owner": "text",
    "status": "Active"
  }
]

List orders for the authenticated user.

get

Returns active and terminal orders in a single time-sorted, cursor-paginated list. Each entry carries full display detail via orderDetails, regardless of status. Supports multi-value hash and status filters; when hash is provided, pagination is skipped.

Query parameters

hashstring · bytes32Optional

Direct lookup by order hash, comma-separated. Max 30 per request. When provided, pagination is skipped.

statusstringOptional

Filter by order status, comma-separated. Multiple values are OR'd.

cursorstringOptional

Opaque cursor from a previous response. Ignored when hash is provided.

limitinteger · int32Optional

Max orders per page (default 50, cap 200). Ignored when hash is provided.

Responses

200

Orders retrieved

application/json

Response body for GET /api/orders.

cursorstring · nullableOptional

Opaque token to pass back as cursor in the next request. null on the last page.

hasMorebooleanRequired

Mirrors cursor.is_some().

400

Invalid query parameters

application/json

401

User not authorized

application/json

get/api/orders

GET /api/orders HTTP/1.1
Accept: */*

{
  "cursor": null,
  "hasMore": true,
  "orders": [
    {
      "execution": [
        {
          "batchId": null,
          "blockNumber": 1,
          "boughtAmount": "text",
          "midPrice": {},
          "soldAmount": "text",
          "surplusBuyAmount": "text",
          "txHash": null
        }
      ],
      "hash": "text",
      "orderDetails": {
        "annotations": {
          "spreadAtSubmissionHbp": null
        },
        "buyToken": "text",
        "createdTimestamp": "2026-08-12T00:01:44.991Z",
        "endTime": "text",
        "limitPrice": {},
        "sellAmount": "text",
        "sellToken": "text",
        "spreadCurve": {
          "endDeltaBps": 1,
          "endSecs": 1,
          "points": [
            {
              "deltaBps": 1,
              "timeSecs": 1
            }
          ],
          "startDeltaBps": 1,
          "startSecs": 1
        },
        "startTime": "text"
      },
      "owner": "text",
      "status": "Active"
    }
  ]
}

Request a single-order quote from the Fynd solver.

post

Public, unauthenticated. Returns a trimmed view of the Fynd response (amounts + gas). Any non-success status or transport error is returned as a 502 with a descriptive message. If Quoting is disabled, 501 is returned.

Body

Minimal inputs for a Fynd passthrough quote.

buyTokenstring · addressRequiredExample: 0xdAC17F958D2ee523a2206206994597C13D831ec7

sellAmountstring · uint256RequiredExample: 1000000

sellTokenstring · addressRequiredExample: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

Responses

200

Quote successful

application/json

Pared-down Fynd quote: amounts, gas, and a reference midprice.

ammSpreadHbpinteger · int64Required

DEX-derived spread in hundredths of a basis point. 10_000 hbp = 1%. Deprecated: use spread instead.

buyAmountstring · uint256Required

buyTokenstring · addressRequired

sellAmountstring · uint256Required

sellTokenstring · addressRequired

501

Fynd solver not enabled on this instance

application/json

502

Quote failed upstream

application/json

post/api/quote

POST /api/quote HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 137

{
  "buyToken": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
  "sellAmount": "1000000",
  "sellToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}

{
  "ammSpreadHbp": 1,
  "buyAmount": "text",
  "buyToken": "text",
  "fee": {
    "totalAmount": "text",
    "totalHbp": 1
  },
  "midPrice": {
    "denominator": "text",
    "numerator": "text"
  },
  "sellAmount": "text",
  "sellToken": "text",
  "spread": {
    "ammSpreadHbp": 1,
    "gasHbp": 1
  }
}

Submit a new liquidity removal request to the system

post

Body

Represents a liquidity removal with SignatureTransfer permit functionality.

This struct encapsulates all necessary information needed to submit a new intent to remove liquidity to the system, including the intent and SignatureTransfer permit data for approvals. User authentication is handled via session-based SIWE verification.

Fields

remove_liquidity The intent to remove liquidity
permit_lp_token The SignatureTransfer permit and signature for the LP token

Responses

200

Liquidity intent successfully submitted

application/json

Response returned after successfully submitting an intent to the system. Contains the unique identifier assigned to the submitted intent.

Fields

hash - Unique identifier assigned to the submitted intent

intentHashstring · bytes32RequiredExample: 0x1234567890123456789012345678901234567890123456789012345678901234

400

Invalid intent, signatures, or session state

application/json

401

User not authorized

application/json

500

Internal server error

application/json

post/api/remove_liquidity

POST /api/remove_liquidity HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 727

{
  "permitLpToken": {
    "permit": {
      "deadline": "1630003600",
      "nonce": "0",
      "permitted": {
        "amount": "1000000000000000000",
        "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
      }
    },
    "signature": {
      "r": "70329708892606663774035422698344599545311796398002379995821142342730166717036",
      "s": "55059184936589248349789125767339054890704358390709680883308715042461925991610",
      "yParity": "false"
    }
  },
  "removeLiquidity": {
    "fee": "3000",
    "lpToken": "0x0000000000000000000000000000000000000000",
    "lpTokenAmount": "1000000000000000000",
    "owner": "0xBE69d72ca5f88aCba033a063dF5DBe43a4148De0",
    "salt": "0xbc99a2cb0a86c1eb704c1b670ec4c59eae55ceaa8f1b0068f170d6d66d1301a1",
    "token0": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "token1": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
  }
}

{
  "intentHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Get the status of the Turbine service

get

Responses

200

Service is running

text/plain

stringOptional

get/api/status

GET /api/status HTTP/1.1
Accept: */*

200

Service is running

text

Verify a SIWE message and create/update the session.

post

Cycles the session id to prevent session fixation attacks.

Body

messagestringRequiredExample:

app.turbine.exchange wants you to sign in with your Ethereum account: 0x1234567890123456789012345678901234567890 Sign-In With Ethereum statement URI: https://app.turbine.exchange Version: 1 Chain ID: 1 Nonce: abc123def456ghi789 Issued At: 2024-01-15T10:30:00Z

signaturestringRequiredExample:

{"r":"0xc135e033b0fe93b22a0b94700963c9628123f6a8fe9b7ea5e5842e11362365ac","s":"0x7d65776eb91d15baf2d08a2739f0bee524529222262d481900761cad92c485ed","yParity":"0x0","v":"0x0"}

Responses

200

SIWE verification successful, session created

No content

400

SIWE verification failed or invalid session state

application/json

500

Internal server error

application/json

post/api/verify

POST /api/verify HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 488

{
  "message": "app.turbine.exchange wants you to sign in with your Ethereum account:\n0x1234567890123456789012345678901234567890\n\nSign-In With Ethereum statement\n\nURI: https://app.turbine.exchange\nVersion: 1\nChain ID: 1\nNonce: abc123def456ghi789\nIssued At: 2024-01-15T10:30:00Z",
  "signature": "{\"r\":\"0xc135e033b0fe93b22a0b94700963c9628123f6a8fe9b7ea5e5842e11362365ac\",\"s\":\"0x7d65776eb91d15baf2d08a2739f0bee524529222262d481900761cad92c485ed\",\"yParity\":\"0x0\",\"v\":\"0x0\"}"
}

No content

Last updated 5 hours ago

Was this helpful?