Gateway CLMM

Open Clmm Position

Changed on

Open a NEW CLMM position with initial liquidity.

Example: connector: 'meteora' network: 'solana-mainnet-beta' pool_address: '2sf5NYcY4zUPXUSmG6f66mskb24t5F8S11pC1Nz5nQT3' lower_price: 150 upper_price: 250 base_token_amount: 0.01 quote_token_amount: 2 slippage_pct: 1 (optional; omit to use the connector's configured slippagePct) wallet_address: (optional) extra_params: {"strategyType": 0} # Meteora-specific

Returns: Transaction hash and position address. position_address is None when the transaction was submitted but not yet confirmed — poll the transaction; the poller's discovery sweep records the position once it lands on-chain.

post/gateway/clmm/open

Request

  • Base URL
    http://localhost:8000
  • URL
    http://localhost:8000/gateway/clmm/open
  • Auth
    HTTP basic

Request body

connectorstring required

CLMM connector (e.g., 'meteora', 'raydium', 'uniswap')

networkstring required

Network ID in 'chain-network' format (e.g., 'solana-mainnet-beta')

pool_addressstring required

Pool contract address

wallet_addressstring nullable

Wallet address (optional, uses default if not provided)

extra_paramsobject nullable

Additional connector-specific parameters

Response

Successful Response

transaction_hashstring required

Transaction hash

position_addressstring nullable

Address of the newly created position. None when the transaction was submitted but not yet confirmed (Gateway only knows the address once the tx lands) — poll the transaction; the poller records the position once it appears on-chain

trading_pairstring required

Trading pair

pool_addressstring required

Pool address

lower_pricestring required

Lower price bound

upper_pricestring required

Upper price bound

base_token_amount_addedstring nullable

Base amount actually added on-chain (confirmed txs only; the requested amount otherwise)

quote_token_amount_addedstring nullable

Quote amount actually added on-chain (confirmed txs only; the requested amount otherwise)

position_rentstring nullable

Native token locked as rent for the position account (refunded on close)

statusstring

Transaction status

Changes

  • 6edd79085219Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      response property position_address list-of-types was widened by adding types null to media type application/json of response 200

    • info

      the request property default value 1 was removed

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 92703f48a69eRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status