---
title: "Create a new exchange"
method: GET
path: "/exchanges/new"
tags: ["exchange"]
---

# Create a new exchange

`GET /exchanges/new`

## Request

- Base URL: `https://plisio.loc/api/v1`
- URL: `https://plisio.loc/api/v1/exchanges/new`
- Auth: API key in query parameter `api_key`

## Query parameters

- `from_currency` string, required
- `to_currency` string, required
- `to_address` string, required
- `from_amount` string
- `to_amount` string
- `amount_currency` string

## Response `201`

ExchangeResponseDto

- ExchangeResponseDto
  - `id` string
  - `from_currency` string
  - `to_currency` string
  - `from_amount` string
  - `to_amount` string
  - `to_address` string: External recipient address (echoed from the request).
  - `deposit_address` string: Where the customer must send from_amount. Partner deposit address for ChangeNow; our generated hash for SwapKit.
  - `status` string
  - `created_at` string

## Other responses

- `401`: Unauthorized
- `422`: Validation error

---

[API](https://skmtc.dev/plisio/apis/plisio-api-plisio-loc.md) · [All operations](https://skmtc.dev/plisio/apis/plisio-api-plisio-loc/llms.txt) · [OpenAPI document](https://skmtc.dev/plisio/apis/plisio-api-plisio-loc/revisions/b54f70a29304?raw)