CLI reference / market / auto-list

stado market auto-list

Invocation

stado market auto-list [OPTIONS] --provider <PROVIDER> --idle-window-s <IDLE_WINDOW_S> --price-gpu <PRICE_GPU> --max-duration-s <MAX_DURATION_S>

Purpose

Keep the listing in step with the queue: list when the queue has been idle for the window, withdraw when work appears

Required inputs and options

Input or optionContract
--provider <PROVIDER>The marketplace to list on Possible values: - vast: Vast.ai: the machine is listed through its host API with the key in the Skarbiec item `vast`, field `api_key`
--idle-window-s <IDLE_WINDOW_S>The queue must be idle this many seconds before listing
--poll-interval-s <POLL_INTERVAL_S>Seconds between polls of the configured Stado queue storage. Required unless --once
--price-gpu <PRICE_GPU>Per-GPU-hour rental price in USD when the machine is listed
--max-duration-s <MAX_DURATION_S>Cap the longest rental a renter can buy from this offer, in seconds; 0 leaves it open-ended
--dry-runPrint the toggle decisions without calling the marketplace. Needs no credential: the decisions come from the queue
--onceEvaluate one poll and exit, instead of looping. With --dry-run this is the one-shot preview a graphical surface can run

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • The queue must be idle this many seconds before listing
  • Required unless --once
  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.