Skip to main content

POST /makers/initialize

Create a pending Makers order.

Reserves an order and returns paymentAddress + nRequiredSol. Once paid, the token is traded from fresh wallets on the chosen pool.

Body​

FieldTypeRequiredDescription
sTokenAddressstringyesToken mint.
sPoolIdstringyesPool id for the mint.
ePoolChosenenumyesRAYDIUM, METEORA, MOONSHOT, PUMPFUN, PUMPSWAP, LAUNCHLAB, DBC. MOONIT and HEAVEN are rejected with 400.
eSpeedenumyesSLOW, NORMAL or FAST. See Makers.

Pool checks​

  • The pool must trade the token on the declared DEX.
  • Its quote token must be tradable against SOL. PumpFun cashback coins and PumpSwap cashback pools are not supported.

Singleton rule​

At most one order awaiting payment per user, counting Holders orders, which share the payment address. 409 if one is pending:

{
"message": "this user already has a pending Makers order — complete or cancel it before initializing another",
"pendingMakersId": "6731…"
}
{
"message": "this user has a pending Holders order paid to the same address — complete or cancel it first",
"pendingHoldersId": "66b4…"
}

Response 202​

{
"makersId": "6731…",
"eSpeed": "NORMAL",
"sEstimatedDuration": "10h",
"sMakersEstimate": "up to 20K",
"nRequiredSol": 1.25,
"sTokenAddress": "…",
"sTokenNameAndSymbol": "MyToken (MTK)",
"sPoolId": "…",
"ePoolChosen": "PUMPSWAP",
"status": "PENDING_PAYMENT",
"paymentAddress": "…"
}
FieldDescription
sEstimatedDuration20h, 10h or 2h, by speed.
sMakersEstimateup to 20K on a SOL-quoted pool, up to 15K otherwise.
sTokenNameAndSymbolEmpty when the token metadata could not be read.

Pay with a plain transfer to paymentAddress, or with POST /makers/pay.

Errors​

StatusMeaning
400Invalid inputs, the pool does not match the token or DEX, or the pool is not supported (MOONIT, HEAVEN, unsupported quote, cashback coin).
409The user already has a pending Makers or Holders order (also when two requests race).

Example​

curl -X POST "$BASE_URL/makers/initialize" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Content-Type: application/json" \
-d '{
"sTokenAddress": "…",
"sPoolId": "…",
"ePoolChosen": "PUMPSWAP",
"eSpeed": "NORMAL"
}'