🔄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

Authorizations

Body

jwtobject

tradingOrderViewobject

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/convert' \
  --header 'Content-Type: application/json' \
  --data '{
    "jwt": {
      "tokenValue": "text",
      "issuedAt": "2025-03-13T22:27:53.577Z",
      "expiresAt": "2025-03-13T22:27:53.577Z",
      "headers": {
        "ANY_ADDITIONAL_PROPERTY": {}
      },
      "claims": {
        "ANY_ADDITIONAL_PROPERTY": {}
      },
      "id": "text",
      "issuer": "text",
      "notBefore": "2025-03-13T22:27:53.577Z",
      "subject": "text",
      "audience": [
        "text"
      ]
    },
    "tradingOrderView": {
      "accountId": "text",
      "from": "text",
      "to": "text",
      "quantity": 1
    }
  }'

200

200

{
  "success": true,
  "data": [
    {
      "accountId": "text",
      "portfolioId": "text",
      "from": {
        "id": "text",
        "operationId": "text",
        "accountId": "text",
        "portfolioId": "text",
        "transactionSide": "CREDIT",
        "transactionType": "FEES",
        "asset": "text",
        "amount": 1,
        "creationTs": "2025-03-13T22:27:53.577Z"
      },
      "to": {
        "id": "text",
        "operationId": "text",
        "accountId": "text",
        "portfolioId": "text",
        "transactionSide": "CREDIT",
        "transactionType": "FEES",
        "asset": "text",
        "amount": 1,
        "creationTs": "2025-03-13T22:27:53.577Z"
      },
      "fees": {
        "id": "text",
        "operationId": "text",
        "accountId": "text",
        "portfolioId": "text",
        "transactionSide": "CREDIT",
        "transactionType": "FEES",
        "asset": "text",
        "amount": 1,
        "creationTs": "2025-03-13T22:27:53.577Z"
      }
    }
  ],
  "errorCode": 1,
  "errorMessage": "text"
}

OK

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}

Authorizations

Path parameters

fromSlugstringrequired

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/convert/{fromSlug}'

200

200

{
  "success": true,
  "data": [
    {
      "slug": "text",
      "name": "text",
      "logoUrl": "text",
      "availableNetworks": [
        "text"
      ]
    }
  ],
  "errorCode": 1,
  "errorMessage": "text"
}

OK

OAuth: client_auth

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

get

/v1/convert/tradingPairs

Authorizations

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/convert/tradingPairs'

200

200

{
  "success": true,
  "data": [
    "text"
  ],
  "errorCode": 1,
  "errorMessage": "text"
}

OK

OAuth: client_auth