POST `/exchange-rates/convert`

使用报价ID执行币种兑换。参考：GAAP/IFRS (Double-Entry Accounting Principles)。quote_id在60秒内有效，兑换后即失效防止重放。

钱包服务 `bearerAuth` application/json

请求体

Schema： service-wallet/internal/handler/dto.ExchangeConvertRequest

字段	类型	必填	示例	约束	描述
`amount`	`string`	是	`100.00`
`quote_id`	`string`	是	`qt_abc123def`
`remark`	`string`	否	`USD to CNY conversion`

响应

状态	描述	Schema
200	兑换结果	`dto.DataResponse-service-wallet/internal/handler/dto/ExchangeConvertResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证或令牌无效	`service-core/base/dto.SimpleResponse`
409	报价已过期或重复使用	`service-core/base/dto.SimpleResponse`
422	兑换金额无效	`service-core/base/dto.SimpleResponse`
500	服务内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

dto.DataResponse-service-wallet/internal/handler/dto/ExchangeConvertResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-wallet/internal/handler/dto.ExchangeConvertResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-wallet/internal/handler/dto.ExchangeConvertResponse

字段	类型	必填	示例	约束	描述
`from_amount`	`string`	否	`100.00`
`from_currency`	`string`	否	`USD`
`message`	`string`	否	`兑换成功`
`quote_id`	`string`	否	`qt_abc123def`
`rate`	`number`	否	`7.24`
`to_amount`	`string`	否	`724.00`
`to_currency`	`string`	否	`CNY`
`transaction_id`	`string`	否	`txn_001`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓