Open Position

Create a new position NFT that represents your liquidity ownership in a DLMM pool. Position NFTs track your share across multiple bins and enable granular liquidity management.

Prerequisites

Before opening a position:

  • Have a valid LBPair object from getPair()

  • Connected wallet with sufficient gas

  • Understanding of position NFTs in DLMM

  • Plan for liquidity distribution (can add later)

Basic Usage

// Get the pair first
const pair = await sdk.Pair.getPair(pairAddress);

// Create a new empty position
const tx = await sdk.Pair.openPosition(pair);

// Execute transaction
const result = await sdk.fullClient.signAndExecuteTransaction({
  transaction: tx,
  signer: keypair
});

console.log("Position NFT created:", result.digest);

Method Signature

async openPosition(
  pair: LBPair, 
  tx?: Transaction
): Promise<Transaction>

Parameters

  • pair: The LBPair to create position for

  • tx: Optional existing transaction to append to

Returns

  • Transaction object ready for execution

  • Position NFT will be transferred to sender

Understanding Position NFTs

Position NFTs in DLMM:

  • Unique ownership: Each NFT represents your specific liquidity

  • Multi-bin support: Can hold liquidity across many price levels

  • Fee tracking: Accumulates your share of trading fees

  • Transferable: Can be sent to other addresses

  • Composable: Can be used in other protocols

Creating and Adding Liquidity

Two-Step Process

// Step 1: Create position
const tx1 = await sdk.Pair.openPosition(pair);
await executeTransaction(tx1);

// Step 2: Add liquidity later
const tx2 = await sdk.Pair.addLiquidity(pair, {
  positionId: "0x...", // From step 1
  amountX: 1000000n,
  amountY: 2000000n,
  // ... distribution params
});

One-Step Process (Recommended)

// Create position and add liquidity together
const tx = await sdk.Pair.openPositionAndAddLiquidity(pair, {
  amountX: 1000000n,
  amountY: 2000000n,
  deltaIds: [-5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5],
  distributionX: [0, 0, 0, 0, 0, 100, 0, 0, 0, 0, 0],
  distributionY: [0, 0, 0, 0, 0, 100, 0, 0, 0, 0, 0]
});

Batch Operations

// Create multiple positions in one transaction
const tx = new Transaction();

// Create positions for different strategies
const position1 = await sdk.Pair.openPosition(pairETHUSDC, tx);
const position2 = await sdk.Pair.openPosition(pairSUIUSDC, tx);

// Execute all at once
await sdk.fullClient.signAndExecuteTransaction({
  transaction: tx,
  signer: keypair
});

Finding Your Position ID

After creation, retrieve the position ID from transaction events:

const result = await sdk.fullClient.signAndExecuteTransaction({
  transaction: tx,
  signer: keypair
});

// Get created object IDs
const createdObjects = result.effects?.created || [];
const positionId = createdObjects.find(obj => 
  obj.owner === 'AddressOwner' // Your address
)?.reference.objectId;

console.log("New position ID:", positionId);

Gas Optimization

Opening an empty position uses minimal gas. Consider:

  • Batch position creation with liquidity addition

  • Use openPositionAndAddLiquidity() for efficiency

  • Reuse existing positions when possible

Common Patterns

Position for Range Order

// Create position for future liquidity
const tx = await sdk.Pair.openPosition(pair);

// Can add liquidity when price reaches target
// Position remains empty until then

Multi-Strategy Positions

// Create separate positions for different strategies
const conservativeTx = await sdk.Pair.openPosition(pair);
const aggressiveTx = await sdk.Pair.openPosition(pair);

// Add different distributions to each

Related Topics

PreviousPosition ManagementNextGet User Positions

Last updated