Skip to main content

Target Volume

Buy a set amount of trading volume in USD for a token, at a price and a duration known before paying. The bot trades on the chosen pool until the volume target is reached.

Unlike Flexi, the client does not pick a budget, swap sizes or pace: Orbitt prices the order from the pool on-chain and the client picks a target and a speed.

Flow​

  1. GET /target-volume/pools/:address — list the token's pools and whether each one can take an order.
  2. GET /target-volume/targets — the volume targets on offer for that pool, each with its lowest price.
  3. GET /target-volume/quote — the speeds available for one target, each with its duration and price.
  4. POST /target-volume/initialize — create the order (or several, paid together). Returns paymentAddress, nTotalSol and nSolLeft.
  5. Send nSolLeft to paymentAddress, or call POST /target-volume/pay to send it from one of the user's wallets.
  6. Follow the order with GET /target-volume/bot/:id until it is FINISHED or STOPPED.

Prices are computed when the order is created and hold for 30 minutes. An order not fully paid by then expires (EXPIRED); create a new one.

Targets and speeds​

FieldValues
nTargetUsd20000, 50000, 100000, 200000, 500000, 1000000
eSpeedFAST, 1H, 3H, 6H, 12H, 24H, 3D, 7D

FAST runs as quickly as the pool allows; its duration differs per order and is returned by quote as nDurationHours. Not every speed is offered for every target: use the ones quote returns.

Order status (sStatus)​

sStatuseStatusMeaning
WAITING_PAYMENT1Created, waiting for SOL at paymentAddress.
STARTING1Payment received, the bot is being funded.
ON_HOLD1Payment received, but the order is on hold. Contact support.
ACTIVE2Trading.
PAUSED2Trading is paused. Contact support.
STOPPING2Stop requested: the bot sells what it holds and closes.
FINISHED3Ended.
STOPPED3Ended after a stop.
CANCELLED4Cancelled before payment.
EXPIRED4Not paid within 30 minutes.

Availability​

Target Volume is switched on per account. Where it is off, the ordering endpoints (pools, targets, quote, initialize, pay) answer 403 with { "message": "Target Volume is not available" }. Reading, cancelling and stopping existing orders always works.

Singleton rule​

A user can have one open (unpaid) order or order group at a time. initialize answers 409 with the open order until it is paid, cancelled or expired.

Endpoints​