aispot CLI

The aispot CLI is the scriptable client for Spot. It is a clap front-end over the Rust token-gateway-sdk crate: every gateway call goes through BuyerClient, SellerClient, or health. Agents should prefer it for a one-shot health check, a Chat Completions call, or the list of developer URLs.

The binary name is aispot. Do not look for a spot package on npm, PyPI, or Homebrew — those names belong to unrelated projects. aispot is not published to those registries.

Install

Build from this repository (Rust 1.78, same pin as the gateway):

cargo run -p aispot -- --help
cargo build --release --locked --bin aispot
./target/release/aispot health

Release uploads a precompiled Linux amd64 artifact named aispot-linux-amd64 (the file inside is dist/aispot), the same way it ships the gateway binary. Other platforms build from source.

The crate lives at aispot/ and depends on token-gateway-sdk/ by path.

Commands

Command	SDK call
`aispot health`	`token_gateway_sdk::health` — `GET {base}/health`
`aispot chat --message TEXT`	`BuyerClient::chat_completions`
`aispot seller register`	`SellerClient::register`
`aispot seller ask`	`SellerClient::submit_ask`
`aispot seller cancel`	`SellerClient::cancel_ask`
`aispot seller capacity`	`SellerClient::report_capacity`
`aispot seller trades`	`SellerClient::list_trades`
`aispot docs`	Print the aispotmarket developer URLs (no network)
`aispot openapi`	Print the OpenAPI URL (no network)

Default API host is https://api.aispotmarket.com. Override with --base-url or SPOT_API_URL. --from-config URL calls the SDK's GET {url}/config discovery (gatewayApiUrl) instead.

Buyer calls need --api-key or SPOT_API_KEY (or BUYER_API_KEY). Authenticated seller calls need --seller-key or SPOT_SELLER_KEY.

aispot health
aispot chat --message "hello" --model gpt-4 --max-price 0.05 --api-key "$SPOT_API_KEY"
aispot docs
aispot seller register --name acme --endpoint http://127.0.0.1:9000/infer --model gpt-4 --api-key sk-seller

See Authentication, Chat completions, Rate limits, and the crate README in aispot/README.md.