NAV
shell

Introduction

The Tradesilvania API allows you to integrate the Tradesilvania trading platform with third party applications, such as trading applications, point of sale systems, and much more. Below you will find details on how the system functions, along with examples in common programming languages.

Tradesilvania provides Fill Or Kill (FOK) orders or Market Orders or Limit Order, through API. Tradesilvania clients can specify a price at which they would like to execute a trade for a given quantity, and if Tradesilvania can match the price, a trade will be done.

The URLs to connect to Tradesilvania’s REST endpoint is: https://api.tradesilvania.com/

Access and use of the API is governed by our Terms of Service and Client Agreement. You can request more features by contacting our developers team.

All endpoints return either a JSON object or array. All request bodies should have content type application/json and be valid JSON.

Support

If you have any issue with api or with the documentation please contact us at [email protected]

Issuing API Credentials

Tradesilvania API requires an api keys to access endpoints. In order to have access at API please contact Tradesilvania Support ([email protected]). After you will receive access at api you can configure and view public and private key from Settings -> API access. In this section you cand see the api keys and enable and disable crypto transfer from your wallets.

API Clients

NodeJS Api client - in progress

Pairs

Get pairs list

Get available pairs from Tradesilvania.

curl "https://api.tradesilvania.com/v2/pairs" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "pairs": ["BTC-EURO", "ETH-EURO", "USDT-EURO", "BTC-USDT"]
}

HTTP Request

GET https://api.tradesilvania.com/v2/pairs

Get Pair Rates

Retrieve prices (bid and ask) for a pair.

curl "https://api.tradesilvania.com/v2/pairs/ETH-EURO" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "ask": 123.32,
    "bids": 123.32
}

HTTP Request

GET https://api.tradesilvania.com/v2/pairs/{pair}

Query Parameters

Parameter Default Required Description
pair - true pair that is available in "Get pairs list"

Orders

Add Market Order

Create a new market order.

curl -d '{"pair":"BTC-EURO", "direction":"buy", "quantity": 120.30}' -H "Content-Type: application/json" X POST "https://api.tradesilvania.com/v2/orders/market" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "orderId": "109941fbd6634e001206f5f4232",
}

HTTP Request

POST https://api.tradesilvania.com/v2/orders/market

Body Parameters

Parameter Default Required Description
pair - true pair that is available in "Get pairs list"
direction - true the order direction (buy, sell)
quantity - true order quantity

Add Limit Order

Create a new limit order.

curl -d '{"pair":"BTC-EURO", "direction":"buy", "quantity": 120.30, "limit": 40000}' -H "Content-Type: application/json" X POST "https://api.tradesilvania.com/v2/orders/limit" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "orderId": "109941fbd6634e001206f5f4232",
}

HTTP Request

POST https://api.tradesilvania.com/v2/orders/limit

Body Parameters

Parameter Default Required Description
pair - true pair that is available in "Get pairs list"
direction - true the order direction (buy, sell)
quantity - true order quantity
limit - true order limit

Add Fok Order

Create a new fok (fill or kill) order.

curl -d '{"pair":"BTC-EURO", "direction":"buy", "quantity": 120.30, "slippage": 10}' -H "Content-Type: application/json" X POST "https://api.tradesilvania.com/v2/orders/fok" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "orderId": "109941fbd6634e001206f5f4232",
}

If order can't fill it's returns JSON structured like this:

{
    "orderId": null
}

HTTP Request

POST https://api.tradesilvania.com/v2/orders/fok

Body Parameters

Parameter Default Required Description
pair - true pair that is available in "Get pairs list"
direction - true the order direction (buy, sell)
quantity - true order quantity
slippage - true acceptable leeway in bps, between 0 and 100

Get Order

Retrieve information about specific orders. API endpoint to get order details. Typically used if you want to know if the order was executed or not.

curl "https://api.tradesilvania.com/v2/orders/dee11d4e-63c6-4d90-983c-5c9f1e79e96c" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "orderId": "109941fbd6634e001206f5f4232",
  "pair": "BTC-EURO",
    "direction": "sell",
  "type": "market",
  "status": "settled",
  "rate": 30200,
  "send": 0.1,
  "receive": 3020
}

HTTP Request

GET https://api.tradesilvania.com/v2/orders/{orderId}

Query Parameters

Parameter Default Required Description
orderId - true order id

Funds

Withdrawal Crypto

Send cryptocurrency to external wallet. The amount must also include the withdrawal fee.

curl -d '{"amount":102.232, "address": "bbbbbbbbb", "destinationTag": "12345" }' -H "Content-Type: application/json" X POST "https://api.tradesilvania.com/v2/wallets/XRP/send" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "transactionId": "109941fbd6634e001206f5f4232",
}

HTTP Request

POST https://api.tradesilvania.com/v2/wallets/{currency}/send

Query Parameters

Parameter Default Required Description
currency - true currency symbol EURO, BTC etc.

Body Parameters

Parameter Default Required Description
amount - true amount of the cryptocurrency you want to send
address - true wallet address in which you want to send
destinationTag - false only for XRP and XML

Get Wallet Balance

Get crypto and fiat wallets balance

curl "https://api.tradesilvania.com/v2/wallets/BTC/balance" \
  -H "Authorization: token"

The above command returns JSON structured like this:

{
    "balance": 0.2323
}

HTTP Request

GET https://api.tradesilvania.com/v2/wallets/{currency}/balance

Query Parameters

Parameter Default Required Description
currency - true currency symbol EURO, BTC etc.