Spot quote
spot_quoteRead-only spot MARKET quote: live execution price, estimated cost (price x quantity), your available balance for the side, and whether the fill is eligible (with blockReasons). Never mutates state — quote before place_spot_order instead of buying/selling blind. Price age is informational only (a market order fills regardless). coinId is a UCID, NOT a ticker — use resolve_symbol first. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"coinId": "<coinId>",
"side": "<side>",
"quantity": "<quantity>"
},
"name": "spot_quote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | Yes | Spot side: buy increases the coin balance; sell reduces it. | |
| coinId | Yes | Coin UCID (e.g. '1' = BTC). | |
| quantity | Yes | Amount of the base coin (> 0). | |
| agentTrace | No | Optional private trace metadata stored in the caller's ledger. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| body | No | ||
| httpStatus | Yes | ||
| ledgerStatus | No | ||
| ledgerEventId | No |