Skip to main content
Orders are how you acquire and release compute time. A buy order increases your capacity’s allocation schedule. A sell order decreases it and returns credits to your balance.

​
Buy orders

Place a buy order to get compute time on a capacity. 
sf orders create --side buy --capacity dev --count 1 --start now --duration 1h --max-price 2.50
If the market has availability at your price, the order fills immediately. If not, the order is cancelled by default (immediate-or-cancel). To keep the order on the book until it fills or you cancel it, use --allow-standing. 
sf orders create --side buy --capacity dev --count 1 --start now --duration 1h \
  --max-price 2.50 --allow-standing

​
Sell orders

Sell back compute time you own. This is useful when you have allocated time you no longer need. 
sf orders create --side sell --capacity dev --count 1 \
  --start now --stop "in 1h" --min-price 1.00 --allow-standing
When a sell order fills, credits are added to your balance and your capacity’s allocation decreases. Nodes on that capacity that no longer have allocated time will terminate.
Sell orders are not guaranteed to fill. Use --allow-standing to keep the order on the book until a buyer matches.

​
Order statuses

StatusDescription
pendingSubmitted, not yet processed
filledExecuted successfully
standingWaiting for a match on the order book
cancelledNo match found (immediate-or-cancel) or manually cancelled
rejectedValidation or system error

​
Check an order

sf orders get <order-id>

│ ORDER ID   ordr__JLBu4arl_9nSLMfF2Ole
│ SIDE       Buy
│ STATUS     Filled at Mar 19, 4:44pm
│ CAPACITY   cap_nuO4nVSM8O3NnsRE7udBe
│ NODES      1
│ PERIOD     Mar 19, 5pm → 6pm
└ MAX PRICE  $2.50/gpu/hr (Filled)

​
List orders

sf orders list

SIDE  STATUS     PERIOD   COUNT  PRICE          CAPACITY                   ID
Sell  Filled     Mar 19       1  ≥$1.00/gpu/hr  cap_nuO4nVSM8O3NnsRE7udBe  ordr_hYuOEmXW...
Buy   Filled     Mar 19       1  ≤$2.50/gpu/hr  cap_nuO4nVSM8O3NnsRE7udBe  ordr__JLBu4ar...
Buy   Cancelled  Mar 12       1  ≤$2.50/gpu/hr  cap_nuO4nVSM8O3NnsRE7udBe  ordr_Qj69x65v...
Filter by side or status. 
sf orders list --side buy --status filled

​
Cancel an order

Cancel a standing order that hasn’t filled yet. 
sf orders cancel <order-id>

​
Time formats

Order start and end times snap to hour boundaries. The CLI accepts several time formats:
  • now — current time
  • in 6h, in 2d — relative time
  • tomorrow, mar 15 — natural language dates
  • 2025-03-15T10:00:00Z — ISO 8601
  • Unix timestamps
Duration can be specified instead of an end time: 1h, 7d, 2w.

​
API reference

See the Orders API for programmatic access.