Documentation Index
Fetch the complete documentation index at: https://docs.kash.bot/llms.txt
Use this file to discover all available pages before exploring further.
Place trades and inspect their status.
Generated from kash docs --json. Each command’s behaviour is documented in-binary via kash trade <subcommand> --help — this page is the structured reference.
Usage
kash trade <subcommand> [options]
Subcommands
kash trade buy
Buy outcome tokens for a market.
Arguments
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
-a, --amount <usdc> | USDC amount as a decimal (max 6 fractional digits) |
--wait | block until the trade reaches a terminal state |
--wait-timeout-ms, --timeout <ms> | wait timeout in milliseconds (default 60000) — distinct from the global —timeout-ms (per-HTTP-request) |
--poll-interval-ms, --poll-interval <ms> | wait poll interval in milliseconds (default 2000) |
--idempotency-key <key> | sets the Idempotency-Key HTTP header |
--auto-idempotency-key | auto-generate an Idempotency-Key (UUID v4) and surface it in the response |
--client-request-id <id> | sets the body-level clientRequestId for replay safety |
--dry-run | preview the request without sending — emits the would-be body and resolved headers |
kash trade sell
Sell outcome tokens back to the market (Kash-orchestrated / hosted-API flow).
Arguments
Options
| Flag | Description |
|---|
-o, --outcome <index> | outcome index (0-based) |
-a, --amount <usdc> | target USDC to receive (decimal, max 6 fractional digits) — NOT tokens-in. Use kash quote sell --tokens <n> if you have a tokens-in figure and want a USDC quote first. |
--wait | block until the trade reaches a terminal state |
--wait-timeout-ms, --timeout <ms> | wait timeout in milliseconds (default 60000) — distinct from the global —timeout-ms (per-HTTP-request) |
--poll-interval-ms, --poll-interval <ms> | wait poll interval in milliseconds (default 2000) |
--idempotency-key <key> | sets the Idempotency-Key HTTP header |
--auto-idempotency-key | auto-generate an Idempotency-Key (UUID v4) and surface it in the response |
--client-request-id <id> | sets the body-level clientRequestId for replay safety |
--dry-run | preview the request without sending — emits the would-be body and resolved headers |
kash trade status
Show the status of a trade. Use —poll to block until terminal.
Arguments
Options
| Flag | Description |
|---|
--poll | poll until the trade reaches a terminal state |
--wait-timeout-ms, --timeout <ms> | poll timeout in milliseconds (default 60000) — distinct from the global —timeout-ms (per-HTTP-request) |
--poll-interval-ms, --poll-interval <ms> | poll interval in milliseconds (default 2000) |
kash trade list
List your trades.
Options
| Flag | Description |
|---|
-s, --status <status...> | status filter; repeat or comma-separate (e.g. —status pending —status executing | —status pending,executing) |
-m, --market <id> | filter by market id |
-l, --limit <n> | page size (1-100) |
-c, --cursor <cursor> | pagination cursor |
-a, --all | walk every page (use with —json for export) |
--ndjson | stream results as newline-delimited JSON (one record per line); implies —all |
kash trade confirm
Confirm a high-value trade using its one-time token.
Arguments
id — trade UUIDtoken (optional) — confirmation token (omit to read from stdin or prompt)
Options
| Flag | Description |
|---|
--token-stdin | read the confirmation token from stdin |
