POST `/exchange-rates/convert`

Execute currency exchange using a quote ID. Reference: GAAP/IFRS (Double-Entry Accounting Principles). The quote_id is valid for 60 seconds and becomes invalid after exchange to prevent replay.

Wallet Service `bearerAuth` application/json

Request Body

Schema: dto.ExchangeConvertRequest

Field	Type	Required	Example
`amount`	`string`	Yes	`100.00`
`quote_id`	`string`	Yes	`qt_abc123def`
`remark`	`string`	No	`USD to CNY conversion`

Responses

Status	Description	Schema
200	Exchange Result	`dto.DataResponse-dto_ExchangeConvertResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated or invalid token	`gitee_com_linmes_authms_base_dto.SimpleResponse`
409	Quote expired or reused	`gitee_com_linmes_authms_base_dto.SimpleResponse`
422	Invalid exchange amount	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.DataResponse-dto_ExchangeConvertResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.ExchangeConvertResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.ExchangeConvertResponse

Field	Type	Required	Example
`from_amount`	`string`	No	`100.00`
`from_currency`	`string`	No	`USD`
`message`	`string`	No	`Redeemed successfully`
`quote_id`	`string`	No	`qt_abc123def`
`rate`	`number`	No	`7.24`
`to_amount`	`string`	No	`724.00`
`to_currency`	`string`	No	`CNY`
`transaction_id`	`string`	No	`txn_001`

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /exchange-rates/convert