---
title: "Request Currency Conversion Rate & Value Multiple Exchanger - POST"
method: POST
path: "/convert"
tags: ["Currency"]
---

# Request Currency Conversion Rate & Value Multiple Exchanger - POST

`POST /convert`

## Request body

- ConvertPostRequest
  - `amount` number, float, required
  - `from` string, required
  - `to` string, required
  - `decimalPoints` integer
  - `exchanger` object[], required
    - `name` string, required
    - `apiKey` string
    - `apiVersion` string
    - `userAgent` string
  - `cacheTime` string

## Response `200`

successful operation

- ConvertResponse
  - `from` string
  - `to` string
  - `originalAmount` number, float
  - `exchangeValue` number, float
  - `convertedAmount` number, float
  - `convertedText` string
  - `exchangerName` string
  - `rateDateTime` string
  - `rateFromCache` boolean

## Other responses

- `400` — Invalid input
- `404` — Invalid input
- `405` — Invalid input

## Changes

- **2026-07-17** `5c4078eeae92` — 1 info
  - api operation id `ConvertCurrency` removed and replaced with `ConvertCurrencyPost`
- **2018-09-25** `bc6746a3bee9` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the success response with the status `200`
- **2018-09-25** `18a6ab79da14` — 2 info
  - api operation id `addPet` removed and replaced with `ConvertCurrency`
  - the endpoint scheme security `petstore_auth` was removed from the API
- **2018-09-25** `319dc6420526` — 1 breaking, 4 info
  - removed the success response with the status `200`
  - api operation id `ConvertCurrencyPost` removed and replaced with `addPet`
  - the endpoint scheme security `petstore_auth` was added to the API
  - removed the non-success response with the status `400`
  - …1 more

[Change history](https://skmtc.dev/me-io/apis/go-swap-server/changes/convert/post.md)

---

[API](https://skmtc.dev/me-io/apis/go-swap-server.md) · [All operations](https://skmtc.dev/me-io/apis/go-swap-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/me-io/go-swap-server/revisions/5c4078eeae92/schema)