🔄Step 5 - Crypto conversion

User can convert one crypto to another. The conversion will be instantly credited on the wallet of the user.

1 - The conversion can be completed using the following endpoint. You will need to provide the AccountId, the token to be changed, the destination token and the quantity.

POST/v1/convert

Body

application/json

jwtJwt (object)

tradingOrderViewTradingOrderView (object)

Response

200

OK

Body

*/*

successboolean

dataarray of ConvertView (object)

errorCodeinteger (int32)

errorMessagestring

Request

JavaScriptCurl

const response = await fetch('/v1/convert', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "success": false,
  "data": [
    {
      "accountId": "text",
      "portfolioId": "text",
      "from": {
        "id": "text",
        "operationId": "text",
        "accountId": "text",
        "portfolioId": "text",
        "transactionSide": "CREDIT",
        "transactionType": "FEES",
        "asset": "text",
        "amount": 0,
        "creationTs": "2024-07-27T07:49:49.017Z"
      },
      "to": {
        "id": "text",
        "operationId": "text",
        "accountId": "text",
        "portfolioId": "text",
        "transactionSide": "CREDIT",
        "transactionType": "FEES",
        "asset": "text",
        "amount": 0,
        "creationTs": "2024-07-27T07:49:49.017Z"
      },
      "fees": {
        "id": "text",
        "operationId": "text",
        "accountId": "text",
        "portfolioId": "text",
        "transactionSide": "CREDIT",
        "transactionType": "FEES",
        "asset": "text",
        "amount": 0,
        "creationTs": "2024-07-27T07:49:49.017Z"
      }
    }
  ],
  "errorMessage": "text"
}

OAuth: user_auth

2 - When you know the token you want to change, you can check all the related destination tokens using this endpoint:

GET/v1/convert/{fromSlug}

Path parameters

fromSlug*string

Response

200

OK

Body

*/*

successboolean

dataarray of Coin (object)

errorCodeinteger (int32)

errorMessagestring

Request

JavaScriptCurl

const response = await fetch('/v1/convert/{fromSlug}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": false,
  "data": [
    {
      "slug": "text",
      "name": "text",
      "logoUrl": "text",
      "availableNetworks": [
        "text"
      ]
    }
  ],
  "errorMessage": "text"
}

OAuth: client_auth

3 - You can also check all the trading pairs available on Stokn using:

GET/v1/convert/tradingPairs

Response

200

OK

Body

*/*

successboolean

dataarray of string

errorCodeinteger (int32)

errorMessagestring

Request

JavaScriptCurl

const response = await fetch('/v1/convert/tradingPairs', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": false,
  "data": [
    "text"
  ],
  "errorMessage": "text"
}

OAuth: client_auth