Stablecoin FX Quick Start

This guide explains how to swap any stablecoin using our Kii API. It covers retrieving balances, checking the current exchange rate, sending the order and verifying execution.

Requirements to be able to trade stablecoins on Kii, via dashboard or API:

• Have a user

• Have an account level 1 at least (to upgrade from level 0 to level 1, you need to complete our KYC verification inside your user settings)

• Have balances on any stablecoin

Endpoints

Staging URL :

https://apstage.proxy.kiiex.io/ap

Prod URL :

https://alphaprod.proxy.kiiex.io/ap

Swap Workflow example

For this example will assume a goal and specify what to do in order, also we'll provide you with all the endpoints related to each step. The goal is:

• Swap USDT → COPM using a market order.

Prerequisites

These are the prerequisites for the step-by-step guide.

1. Create your Kii account:

   1. Go to https://kiiex.io/ and click on login, and create your user

      1. You can also follow our guide on Set up your Kii Account

2. Update your account from level 0 to level 1 by following our KYC flow to be able to swap

3. Create your trader API Key on our panel to follow the next steps

Step-by-step

These are the steps to fully create a swap and withdraw it:

1. Authenticate your user via api

   1. Authenticate your User via API

2. Create a USDT deposit. If you have already created a deposit, check your current balance

   1. Create Deposit

   2. POST /GetAccountPositions

3. Get the current COPM/USDT rate

   1. Get Current Rate

4. Create market order (buy COPM)

   1. Create a SWAP

5. Verify order was filled

   1. Get SWAP status

6. Get trade details (swap info)

   1. POST /GetTradesHistory

7. Confirm the new COPM balance using the get account positions endpoint

   1. Get Account Balances

8. Create a COPM withdrawal, it could be to another wallet or to your bank account

   1. Create a Withdrawal

9. Check your COPM withdrawal status

   1. Check Withdrawal status

How do I perform the swap workflow using the API?

API endpoints

Authenticate your User via API

Authenticate user session

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/AuthenticateUser

Body

application/json

Responses

200

Authentication result

application/json

authenticatedbooleanOptional

post

/AuthenticateUser

HTTPcURLJavaScriptPython

POST /ap/AuthenticateUser HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "APIKey": "text",
  "Signature": "text",
  "UserId": "text",
  "UserName": "text",
  "Nonce": "text"
}

200

Authentication result

{
  "authenticated": true,
  "user": {
    "userId": 1,
    "userName": "text",
    "email": "text",
    "emailVerified": true,
    "accountId": 1,
    "omsId": 1,
    "use2FA": true
  }
}

Create Deposit

Create a new deposit ticket

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/CreateDepositTicket

Body

application/json

assetManagerIdintegerOptional

accountIdintegerOptional

assetIdintegerOptional

assetNamestring · nullableOptional

amountnumberOptional

omsIdintegerOptional

requestCodestring · nullableOptional

requestIPstring · nullableOptional

requestUserintegerOptional

requestUserNamestring · nullableOptional

operatorIdintegerOptional

StatusintegerOptional

feeAmtnumberOptional

updatedByUserintegerOptional

updatedByUserNamestring · nullableOptional

ticketNumberintegerOptional

depositInfostring · nullableOptional

createdTimestampstring · date-timeOptional

lastUpdateTimestampstring · date-timeOptional

commentsstring · nullableOptional

attachmentsstring · nullableOptional

Responses

200

Deposit ticket creation result

application/json

successbooleanOptional

requestcodestringOptional

post

/CreateDepositTicket

HTTPcURLJavaScriptPython

POST /ap/CreateDepositTicket HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 421

{
  "assetManagerId": 1,
  "accountId": 1,
  "assetId": 1,
  "assetName": "text",
  "amount": 1,
  "omsId": 1,
  "requestCode": "text",
  "requestIP": "text",
  "requestUser": 1,
  "requestUserName": "text",
  "operatorId": 1,
  "Status": 1,
  "feeAmt": 1,
  "updatedByUser": 1,
  "updatedByUserName": "text",
  "ticketNumber": 1,
  "depositInfo": "text",
  "createdTimestamp": "2026-03-01T07:17:28.489Z",
  "lastUpdateTimestamp": "2026-03-01T07:17:28.489Z",
  "comments": "text",
  "attachments": "text"
}

200

Deposit ticket creation result

{
  "success": true,
  "requestcode": "text"
}

Get Account Balances

Get account positions (balances)

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/GetAccountPositions

Body

application/json

AccountIdintegerOptional

OMSIdintegerOptional

IncludePendingbooleanOptional

Responses

200

Account balances

application/json

omsIdintegerOptional

accountIdintegerOptional

productSymbolstringOptional

productIdintegerOptional

amountnumberOptional

holdnumberOptional

post

/GetAccountPositions

HTTPcURLJavaScriptPython

POST /ap/GetAccountPositions HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "AccountId": 1,
  "OMSId": 1,
  "IncludePending": true
}

200

Account balances

[
  {
    "omsId": 1,
    "accountId": 1,
    "productSymbol": "text",
    "productId": 1,
    "amount": 1,
    "hold": 1
  }
]

Get Current Rate

Get market snapshot

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/GetLevel1SummaryMin

Body

application/json

OMSIdintegerOptional

BaseCurrencystringOptional

QuoteCurrencystringOptional

InstrumentIdsstringOptional

Responses

200

Market data snapshot

application/json

itemsstring[]Optional

post

/GetLevel1SummaryMin

HTTPcURLJavaScriptPython

POST /ap/GetLevel1SummaryMin HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "OMSId": 1,
  "BaseCurrency": "text",
  "QuoteCurrency": "text",
  "InstrumentIds": "text"
}

200

Market data snapshot

[
  [
    "text"
  ]
]

Create a SWAP

Create a new order

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/SendOrder

Body

application/json

InstrumentIdintegerOptional

OMSIdintegerOptional

AccountIdintegerOptional

TimeInForceintegerOptional

ClientOrderIdintegerOptional

OrderIdOCOintegerOptional

UseDisplayQuantitybooleanOptional

SideintegerOptional

quantitynumberOptional

OrderTypeintegerOptional

PegPriceTypeintegerOptional

LimitPricenumberOptional

PostOnlybooleanOptional

Responses

200

Order status

application/json

statusstringOptional

errormsgstringOptional

OrderIdintegerOptional

post

/SendOrder

HTTPcURLJavaScriptPython

POST /ap/SendOrder HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "InstrumentId": 1,
  "OMSId": 1,
  "AccountId": 1,
  "TimeInForce": 1,
  "ClientOrderId": 1,
  "OrderIdOCO": 1,
  "UseDisplayQuantity": true,
  "Side": 1,
  "quantity": 1,
  "OrderType": 1,
  "PegPriceType": 1,
  "LimitPrice": 1,
  "PostOnly": true
}

200

Order status

{
  "status": "text",
  "errormsg": "text",
  "OrderId": 1
}

Get SWAP status

Get single order status

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/GetOrderStatus

Body

application/json

omsIdintegerOptional

accountIdintegerOptional

orderIdintegerOptional

Responses

200

Order status details

application/json

OrderIdintegerOptional

OrderStatestringOptional

QuantityExecutednumberOptional

AvgPricenumberOptional

post

/GetOrderStatus

HTTPcURLJavaScriptPython

POST /ap/GetOrderStatus HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "omsId": 1,
  "accountId": 1,
  "orderId": 1
}

200

Order status details

{
  "OrderId": 1,
  "OrderState": "text",
  "QuantityExecuted": 1,
  "AvgPrice": 1
}

Get trades history

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/GetTradesHistory

Body

application/json

omsIdintegerOptional

accountIdintegerOptional

instrumentIdintegerOptional

tradeIdintegerOptional

orderIdintegerOptional

userIdintegerOptional

startTimestampintegerOptional

endTimestampintegerOptional

depthintegerOptional

startIndexintegerOptional

executionIdintegerOptional

Responses

200

List of executed trades

application/json

tradeIdintegerOptional

orderIdintegerOptional

quantitynumberOptional

pricenumberOptional

post

/GetTradesHistory

HTTPcURLJavaScriptPython

POST /ap/GetTradesHistory HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "omsId": 1,
  "accountId": 1,
  "instrumentId": 1,
  "tradeId": 1,
  "orderId": 1,
  "userId": 1,
  "startTimestamp": 1,
  "endTimestamp": 1,
  "depth": 1,
  "startIndex": 1,
  "executionId": 1
}

200

List of executed trades

[
  {
    "tradeId": 1,
    "orderId": 1,
    "quantity": 1,
    "price": 1
  }
]

Create a Withdrawal

Initiates the withdrawal of funds from an account

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/CreateWithdrawTicket

Body

application/json

OMSIdintegerOptional

AccountIdintegerOptional

ProductIdintegerOptional

AmountnumberOptional

feeAmountnumberOptional

TemplateFormobjectOptional

TemplateTypestringOptional

Responses

200

Withdrawal request result

application/json

resultbooleanOptional

errormsgstringOptional

errorcodeintegerOptional

detailstringOptional

post

/CreateWithdrawTicket

HTTPcURLJavaScriptPython

POST /ap/CreateWithdrawTicket HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "OMSId": 1,
  "AccountId": 1,
  "ProductId": 1,
  "Amount": 1,
  "feeAmount": 1,
  "TemplateForm": {},
  "TemplateType": "text"
}

200

Withdrawal request result

{
  "result": true,
  "errormsg": "text",
  "errorcode": 1,
  "detail": "text"
}

Check Withdrawal status

Returns an array of withdraw tickets from the specified OMS and Account

post

https://apstage.proxy.kiiex.io/aphttps://alphaprod.proxy.kiiex.io/ap

/GetWithdrawTickets

Body

application/json

OMSIdintegerOptional

AccountIdintegerOptional

StartIndexintegerOptional

LimitintegerOptional

Responses

200

List of withdraw tickets

application/json

assetManagerIdintegerOptional

accountIdintegerOptional

assetIdintegerOptional

assetNamestringOptional

amountnumberOptional

templateFormstringOptional

templateFormTypestringOptional

omsIdintegerOptional

requestCodestringOptional

requestIPstringOptional

requestUserIdintegerOptional

requestUserNamestringOptional

operatorIdintegerOptional

StatusintegerOptional

feeAmtnumberOptional

updatedByUserintegerOptional

updatedByUserNamestringOptional

ticketNumberintegerOptional

createdTimestampstring · date-timeOptional

lastUpdateTimestampstring · date-timeOptional

CommentsstringOptional

AttachmentsstringOptional

AuditLogstringOptional

post

/GetWithdrawTickets

HTTPcURLJavaScriptPython

POST /ap/GetWithdrawTickets HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "OMSId": 1,
  "AccountId": 1,
  "StartIndex": 1,
  "Limit": 1
}

200

List of withdraw tickets

[
  {
    "assetManagerId": 1,
    "accountId": 1,
    "assetId": 1,
    "assetName": "text",
    "amount": 1,
    "templateForm": "text",
    "templateFormType": "text",
    "omsId": 1,
    "requestCode": "text",
    "requestIP": "text",
    "requestUserId": 1,
    "requestUserName": "text",
    "operatorId": 1,
    "Status": 1,
    "feeAmt": 1,
    "updatedByUser": 1,
    "updatedByUserName": "text",
    "ticketNumber": 1,
    "createdTimestamp": "2026-03-01T07:17:28.489Z",
    "lastUpdateTimestamp": "2026-03-01T07:17:28.489Z",
    "Comments": "text",
    "Attachments": "text",
    "AuditLog": "text"
  }
]