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
| Field | Type | Required | Description |
|---|---|---|---|
sTokenAddress | string | yes | Token mint. |
sPoolId | string | yes | Pool id for the mint. |
ePoolChosen | enum | yes | RAYDIUM, METEORA, MOONSHOT, PUMPFUN, PUMPSWAP, LAUNCHLAB, DBC. MOONIT and HEAVEN are rejected with 400. |
eSpeed | enum | yes | SLOW, 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": "…"
}
| Field | Description |
|---|---|
sEstimatedDuration | 20h, 10h or 2h, by speed. |
sMakersEstimate | up to 20K on a SOL-quoted pool, up to 15K otherwise. |
sTokenNameAndSymbol | Empty when the token metadata could not be read. |
Pay with a plain transfer to paymentAddress, or with
POST /makers/pay.
Errors
| Status | Meaning |
|---|---|
400 | Invalid inputs, the pool does not match the token or DEX, or the pool is not supported (MOONIT, HEAVEN, unsupported quote, cashback coin). |
409 | The 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"
}'