Create a LithosDex pool

post/dex/pools/createapi_key

Sends four transactions in turn: the pool NFT mint, the vault NFT mint, the mint of the NFT that owns the provision, and the genesis, which creates the pool, its vault and this wallet's provision. Every box one transaction passes to the next is held at the wallet before the first send, so nothing else spends it. The chain stops at the first transaction the node does not accept, and reports those after it as unsent. Besides the locked share, a token/token pool's boxes hold 6.3 ERG and 2.3 ERG for storage rent and its vault one unit of each token, and an ERG/token vault holds 0.1 ERG, none of it recoverable. Needs acknowledgeLocked. The pool is listed once its genesis is in a block.

Request body

LDPoolCreateExecuteRequest · application/json

tokenXstringrequired
ERG for an ERG/token pool, or a token/token pool's first token id
tokenYstringrequired
The pool's other token id
amountXstringrequired
The pool's reserve of X at genesis; nanoERG for ERG, at least 0.01 ERG
amountYstringrequired
▶
feeParamsLDFeeParams
Fee numerators over feeDenom. dexFeeNum stays in the pool; ergFeeNum / tokenFeeNum are set aside for liquidity providers.
- dexFeeNuminteger · int64required
- ergFeeNuminteger · int64required
- tokenFeeNuminteger · int64required
- feeDenominteger · int64required
  Denominator of every numerator above
acknowledgeLockedbooleanrequired
Must be true: the pool's own boxes and its locked share can never be taken back

Responses

200The four sends, as far as they wentLDPoolCreated▶

outcomestringrequired
accepted when all four were, else the first step's that was not
one ofacceptedrejecteduncertainunsent
kindstringrequired
one ofn2tt2t
poolNFTstringrequired
vaultNFTstringrequired
provTokenstringrequired
ownerNFTstringrequired
The NFT in this wallet that owns the creator's provision
provisionBoxIdstringrequired
The creator's provision, which genesis creates
▶
stepsLDPoolCreateStep[]required
- stepstringrequired
  one ofPOOL_NFTVAULT_NFTOWNER_NFTGENESIS
- txIdstringrequired
- outcomestringrequired
  unsent: an earlier transaction was not accepted
  one ofacceptedrejecteduncertainunsent
- reasonstring
  The node's refusal, or why the transaction was not sent

400The request is malformed, names ERG as tokenY or one token twice, offers an ERG reserve under 0.01 ERG, gives fees out of bounds, or lacks acknowledgeLocked.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

403Missing or wrong api_keyApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

409The wallet's boxes moved while the chain was built. Resend.LDStateChangedResponse▶

errorintegerrequired
reasonstringrequired
detailstringrequired
What moved, and what it moved to
poolBoxIdstring
Current pool box id
vaultBoxIdstring
Current vault box id
provisionBoxIdstring
Current provision box id

422The wallet cannot cover the reserves, boxes and fees.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

503The node or wallet did not answer. Nothing was sent. Retry.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

defaultErrorApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

← PreviousQuote a new LithosDex pool Next →Quote a swap order on any pool