Create Bonding Pool
This endpoint creates a single-sided liquidity pool where only one asset (asset A) needs to be deposited initially. The pool uses a Linear Price Ramp bonding curve mechanism to establish price discovery and liquidity bootstrapping.
Single-Sided Pool Mechanics
Single-sided pools use a Linear Price Ramp bonding curve that differs from constant product pools:
- Only asset A requires an initial deposit
- Price follows a linear progression: P(S) = P_start + S * (P_end - P_start)
- Where S is the fraction of tokens sold (tokens_sold / initial_supply)
- Ideal for new token launches and price discovery
- Graduates to constant product (x*y=k) after reaching graduation threshold
Pool Creation Process
- Validate request parameters and authentication
- Verify host configuration and fee structure
- Calculate Linear Price Ramp parameters (start/end prices)
- Submit pool creation to the settlement service
- Store pool metadata for deposit confirmation
- Return pool ID and deposit instructions
Fee Structure
Fees are split between:
- LP providers (lp_fee_rate_bps)
- Host platform (if namespace provided)
- Flashnet protocol
Authentication
Requires a valid JWT bearer token. The token’s public key must match the pool_owner_public_key in the request.
After Creation
After successful creation, the pool owner must:
- Send the initial asset A deposit to the pool’s address
- Call the confirm deposit endpoint to activate the pool
Arguments
pool_owner_public_key- Public key of the pool creatorasset_a_token_public_key- Public key of the deposited assetasset_b_token_public_key- Public key of the paired assetasset_a_initial_reserve- Amount to depositgraduation_threshold_pct- Percentage of initial supply to sell before graduationtarget_b_raised_at_graduation- Target asset B amount that determines end pricelp_fee_rate_bps- LP fee in basis pointstotal_host_fee_rate_bps- Total host fees in basis pointshost_namespace- Optional host identifiernonce- Unique value for replay protectionsignature- Request signature
Returns
202 Acceptedwith pool creation details and deposit address400 Bad Requestif validation fails401 Unauthorizedif authentication fails500 Internal Server Errorif creation fails
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Single-sided pool creation parameters including bonding curve configuration and fee settings
Request body for creating a new single-sided AMM pool.
Single-sided pools allow liquidity providers to deposit only one asset (asset A), while the pool creates a Linear Price Ramp bonding curve against a paired asset (asset B). This is useful for launching new tokens with price discovery and initial liquidity.
Response
Pool creation initiated. Initial deposit required to activate pool.
Response for pool creation