# Bity Exchange API API

> Bity Exchange API API on Apizie: 14 endpoints (List currencies, Get a single currency, List previously placed orders, Place an order, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/business:bity/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `business:bity`
- Category: Business
- Status: byok
- Source: https://bity.com
- Page: https://zieapi.vercel.app/api/business/bity
- OpenAPI: https://zieapi.vercel.app/api/business/bity/openapi.json

The present document gives the technical details enabling one to make request to and understand the responses of the Exchange API. Should you want to know what is possible to do with the API, please consult the product…

## Endpoints

### List currencies
`GET https://zieapi.vercel.app/v1/business:bity/get-currencies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tags | array | no | Comma-separated list of tags. Currencies that contain all tags will be filtered. |

### Get a single currency
`GET https://zieapi.vercel.app/v1/business:bity/currencies-get-by-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| currency_code | string | yes | Currency code identifying the currency about which to return information. |

### List previously placed orders
`GET https://zieapi.vercel.app/v1/business:bity/list-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | no | Number of the page to retrieve, defaults to the first page (1). See also the `Link` header in the 200 response. |
| page_size | number | no | Number of orders to include in a page. When not specified, 100. |
| status | string | no | When specified, restrict the orders listing to orders with a specific status. The currently understood values are: - `finalized`: Only… |

### Place an order
`POST https://zieapi.vercel.app/v1/business:bity/place-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Estimate the amount of an order
`POST https://zieapi.vercel.app/v1/business:bity/orders-calculate-amount-estimate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Perform several estimations in one request
`POST https://zieapi.vercel.app/v1/business:bity/orders-perform-multiple-estimations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get the details of an order
`GET https://zieapi.vercel.app/v1/business:bity/orders-get-order-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_uuid | string | yes | ID of the order. |

### Get the QR-bill of an order where the input is bank_transfer.
`GET https://zieapi.vercel.app/v1/business:bity/orders-get-qr-bill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_uuid | string | yes | Identifier of the order for which to retrieve the QR-bill image. |

### Cancel an order
`POST https://zieapi.vercel.app/v1/business:bity/cancel-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_uuid | string | yes | Identifier of the order to attempt to cancel |

### Duplicate an order
`POST https://zieapi.vercel.app/v1/business:bity/duplicate-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_uuid | string | yes | ID of the order to duplicate. |

### Execute order
`POST https://zieapi.vercel.app/v1/business:bity/execute-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_uuid | string | yes | Identifier of the order to attempt to execute |

### Sign proof of wallet ownership message
`POST https://zieapi.vercel.app/v1/business:bity/orders-submit-signature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_uuid | string | yes | ID of the order. |

### List currency pairs
`GET https://zieapi.vercel.app/v1/business:bity/currencies-get-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| input | string | no | Retrieve all pairs for given input currency code. This parameter can be repeated several times to match many input currencies. |
| output | string | no | Retrieve all pairs for given output currency code. This parameter can be repeated several times to match many output currencies. |
| enabled | string | no | Retrieve all pairs that are enabled for trading or not. |

### Read payment information
`POST https://zieapi.vercel.app/v1/business:bity/other-extract-qr-payment-info` (byok)

## Example
```
curl "https://zieapi.vercel.app/v1/business:bity/get-currencies" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Bity Exchange API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/business:bity/get-currencies with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Bity Exchange API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Bity Exchange API itself also needs your own key from exchange.api.bity.com.

### Can AI agents use the Bity Exchange API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key business:bity.

### What is the status of the Bity Exchange API API?
Needs your own provider key (bring your own key)