Advanced Trade: Converts
resource: converts — stablecoin/currency conversion (CVT01–CVT03)
createQuote (CVT01)
Requests a conversion quote between two currencies (e.g. USD → USDC).
| Field | Required | Description |
|---|---|---|
fromCurrency | ✓ Yes | Source currency. |
toCurrency | ✓ Yes | Destination currency. |
amount | ✓ Yes | Amount to convert, in fromCurrency. |
Output: single quote/trade record — tradeID, status, fromCurrency, toCurrency, fromAmount, toAmount, expiresAt.
Caution — unverified field mapping:
fromCurrency/toCurrency are sent to Coinbase as from_account/to_account. It was not independently verified whether Coinbase's Convert Quote endpoint accepts bare currency tickers there, or requires account UUIDs (resolvable via accounts/list). If quotes fail unexpectedly, try resolving to an accountId first.
commitTrade (CVT02)
Commits (executes) a previously-quoted conversion — this moves funds.
| Field | Required | Description |
|---|---|---|
tradeId | ✓ Yes | The trade ID returned by createQuote. |
Output: same shape as createQuote.
No automatic retry on 429: this operation opts out of the transport's automatic rate-limit retry, because there's no confirmed idempotency mechanism for re-committing the same trade ID. A 429 surfaces to the caller as-is — don't blindly retry it yourself without checking whether the trade already committed.
getTrade (CVT03)
Looks up an existing conversion trade.
| Field | Required | Description |
|---|---|---|
tradeId | ✓ Yes | The trade ID to look up. |
Output: same shape as createQuote.