Quickstart

This walk opens a buy request for GPU nodes, waits for quotes, and reads them.

1. Sign in

The first command you run signs you in when no session is saved. To sign in on its own:

stoa login

Enter your Stoa Markets email, password and second factor. Login and sessions has the detail. stoa whoami confirms the marketplace is ready for your organization.

2. Find the hardware

The catalog lists the categories the venue trades and the GPU parts a request can name:

stoa categories
stoa assets search h100

Each part has a slug, for example h100-sxm5. The request file names the GPU by that slug.

3. Read the request schema

The venue publishes every field a request accepts, with its allowed values and bounds:

stoa rfq schema

Add --json to get the same schema as structured data. The Request file page explains the fields in reading order.

4. Print a request file and fill it in

stoa rfq template --direction BUY > h100-nodes.toml

The file is commented TOML. Open it in an editor and fill in the hardware, the quantity, the terms and the delivery location. Leave a field out when you have no requirement for it.

5. Validate with a dry run

stoa rfq create -f h100-nodes.toml --dry-run

The venue checks the file and prints the composition it would freeze: the asset, the configuration split into firm specifications and minimums (vocabulary values as the venue files them), the quantity and unit, the terms, and the delivery details dealers will see. It also prints the binding statement. Nothing is sent. A refusal names the field to fix. Fix the file until the dry run is clean; a clean dry run is a request the venue accepts.

6. Open the request

stoa rfq create -f h100-nodes.toml

The client prints the same summary, then the statement you agree to when you send:

I have reviewed the details above and agree that this request and any resulting trade are governed by the Terms of Sale. Accepting a quote creates a binding trade.

Type yes to send. The client prints the request number, the number of dealers invited, the quote deadline and the link:

Created RFQ STOA-RFQ-7K3Q9M (ACTIVE) at 2026-09-26 17:04 UTC; dealers invited: <count>; quote deadline 2026-10-03 17:04 UTC.
Review and accept: https://markets.stoaexchange.com/rfq/6f1c...

Every create carries an idempotency key, printed in the summary. Running the same command again with --idempotency-key <key> returns the existing request instead of opening a second one, and the client labels the result REPLAY.

7. Read the quotes

Dealers quote until the deadline. Your organization's requests, newest first:

stoa rfq list

One request with its configuration, the dealers invited, and every quote received, by its id or by the STOA-RFQ number the web application shows:

stoa rfq get STOA-RFQ-7K3Q9M

For each quote the client shows the dealer, the price per unit and the total, the grade offered, the quantity available, the lead time, the warranty, the validity, and the dealer's conditions. --json returns the same data for a script or an agent.

8. Accept in the web application

Open the link printed by rfq get, review the quote, and accept it there. Accepting a quote creates a binding trade and the web application is the only place that step is offered. Settlement then proceeds as it does for any Stoa Markets trade.