---
title: "Convert between assets"
method: GET
path: "/api/v1/convert"
tags: ["Conversion"]
---

# Convert between assets

`GET /api/v1/convert`

Server-side conversion between any two active assets (crypto AND fiat). `to`
accepts a CSV for multi-target conversion; reversing is just swapping `from`/`to`.
Conversion is linear, so `value = unit_rate * amount`. Fiat FX rates refresh
~twice daily; crypto rates ~every minute.

## Query parameters

- `from` string, required — Source asset slug.
- `to` string, required — Target asset slug(s), comma-separated (up to 10).
- `amount` number, nullable — Amount of the source asset to convert (default 1).

## Response `200`

- object
  - `data` object
    - `from` object
      - `slug` string
      - `symbol` string
    - `amount` integer
    - `results` object[]
      - `slug` string
      - `symbol` string
      - `value` string

## Other responses

- `404`

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)