Cryptorg Futures Bots API (2.0)

Download OpenAPI specification:Download

Cryptorg API for automatic futures bot control

Authorization

API Key

First create an API KEY in the Cryptorg account center.

  1. Open Accesses -> API Keys.
  2. Click on "Create new API key" button.
  3. Enter your current password and click "Create key" button

Now you have an API Key. You can see him on your List of API Keys. Key and Secret grant you access to our API. After 30 mins a secret will be hidden!

Authentication

Each request to API need authentication. For authenticate you need create header and put him to your request.

HEADER example:

[
    "CTG-API-SIGNATURE: HASH",
    "CTG-API-KEY: API_KEY",
    "CTG-API-NONCE: NONCE"
]

Where

  • NONCE - Epoch time in seconds.
  • API_KEY - Your API key.
  • URL - Request string after our API server address. For example: "/bot-futures/all".
  • QUERY - GET params. For example: "exchange=CRYPTORG_FUTURES".
  • HASH - Crypted string meked from URL, NONCE, QUERY and API_SECRET.
HASH example:
HASH_HMAC(SHA256, BASE64_ENCODE(URL + "/" + NONCE + "/" + QUERY) , API_SECRET)

Access

Cryptorg Access

Futures Access List

Futures Access List

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}

BotsFutures

Cryptorg Bots Futures

Get list of all user's bots

Get list of all user's bots

query Parameters
exchange
required
string
Example: exchange=CRYPTORG_FUTURES

Exchange

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}

Get bot details

Get bot details

query Parameters
botId
required
integer <int64>

Bot Id

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}

Get bot logs

Get bot logs

query Parameters
botId
required
integer <int64>

Bot Id

limit
integer <int64>

Records limit

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}

Turn on bot

Turn on bot

query Parameters
botId
required
integer <int64>

Bot Id

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": "Command was sent"
}

Turn off bot

Turn off bot

query Parameters
botId
required
integer <int64>

Bot Id

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": "Command was sent"
}

Create a new bot

Create a new bot

query Parameters
accessId
required
integer <int64>
Example: accessId=33200

Access Id

exchange
required
string
Example: exchange=CRYPTORG_FUTURES

Exchange

pairTitle
required
string
Example: pairTitle=USDT-BNB

Pair title

title
required
string

Title

strategy
required
string
Enum: "LONG" "SHORT"

Strategy

leverage
required
integer <int64>

Leverage

marginMode
required
string
Enum: "ISO" "CROSS"

Margin mode

typeTakeProfit
required
string
Enum: "LIMIT" "STOP-MARKET"

Type take profit

typeFirstOrder
required
string
Enum: "LIMIT" "MARKET"

Type first order

percentTakeProfit
required
float [ 0.01 .. 99.99 ]

Percent take profit

percentSafetyOrder
required
float [ 0.01 .. 99.99 ]

Percent safety order

volumeFirstOrder
required
float

Volume first order

volumeSafetyOrder
float

Volume safety order
Required if param "martingaleScale" is filled in

countOrderMax
integer [ 1 .. 50 ]

Count order max

martingaleScale
float [ 1.05 .. 2 ]

Martingale scale

dynamicStepScale
float [ 1.05 .. 2 ]

Dynamic step scale

cycleLimitScale
integer <int64>

Cycle limit scale

indicatorGroup
string
Enum: "NOTHING" "FOMO" "DIVER" "TRENDS" "TRENDS_CROSSING" "OSCILLATORS"

Group indicator

  • NOTHING - Does not use
  • FOMO - FOMO
  • DIVER - Diver
  • TRENDS - Moving Averages
  • TRENDS_CROSSING - Moving Average Crossovers
  • OSCILLATORS - Oscillators

indicatorName
string

Group indicator name
Required if param "indicatorGroup" is filled in, except "NOTHING"

Allowed values for "indicatorGroup" and "indicatorName" pair

  • FOMO
    • BTCUSDTPERP.small - USDT-BTC, small overbought/oversold
    • BTCUSDTPERP.classic - USDT-BTC, classic overbought/oversold
    • BTCUSDTPERP.deep - USDT-BTC, deep overbought/oversold
    • ETHUSDTPERP.small - USDT-ETH, small overbought/oversold
    • ETHUSDTPERP.classic - USDT-ETH, classic overbought/oversold
    • ETHUSDTPERP.deep - USDT-ETH, deep overbought/oversold
    • BNBUSDTPERP.small - USDT-BNB, small overbought/oversold
    • BNBUSDTPERP.classic - USDT-BNB, classic overbought/oversold
    • BNBUSDTPERP.deep - USDT-BNB, deep overbought/oversold
  • DIVER
    • diver - Divergence signal
  • TRENDS
    • EMA_5 - EMA, 5 period
    • SMA_5 - SMA, 5 period
    • EMA_10 - EMA, 10 period
    • SMA_10 - SMA, 10 period
    • EMA_20 - EMA, 20 period
    • SMA_20 - SMA, 20 period
    • EMA_30 - EMA, 30 period
    • SMA_30 - SMA, 30 period
    • EMA_50 - EMA, 50 period
    • SMA_50 - SMA, 50 period
    • EMA_100 - EMA, 100 period
    • SMA_100 - SMA, 100 period
  • TRENDS_CROSSING
    • EMA_CROSSING_5 - EMA crossover, 5 period
    • SMA_CROSSING_5 - SMA crossover, 5 period
    • EMA_CROSSING_10 - EMA crossover, 10 period
    • SMA_CROSSING_10 - SMA crossover, 10 period
    • EMA_CROSSING_20 - EMA crossover, 20 period
    • SMA_CROSSING_20 - SMA crossover, 20 period
    • EMA_CROSSING_30 - EMA crossover, 30 period
    • SMA_CROSSING_30 - SMA crossover, 30 period
    • EMA_CROSSING_50 - EMA crossover, 50 period
    • SMA_CROSSING_50 - SMA crossover, 50 period
    • EMA_CROSSING_100 - EMA crossover, 100 period
    • SMA_CROSSING_100 - SMA crossover, 100 period
  • OSCILLATORS
    • bbands - Bollinger Bands
    • MACD.s_crossing_macd_and_signal - MACD. Crossing MACD and signal lines
    • MACD.s_crossing_macd_and_zero_level - MACD. Crossing MACD and zero level
    • MACD.s_crossing_macdhist_and_zero_level - MACD. Histogram MACD, changing trend
    • BOP - Balance Of Power
    • stochastic.s_overbought_and_oversold_levels - Stochastic. Overbought and oversold levels
    • stochastic.s_crossing_k_and_d - Stochastic. Crossing K and D lines
    • stochastic_fast.s_overbought_and_oversold_levels - Stochastic Fast. Overbought and oversold levels
    • stochastic_fast.s_crossing_k_and_d - Stochastic Fast. Crossing K and D lines
    • RSI - RSI

indicatorInterval
string

Group indicator interval
Required if param "indicatorName" is filled in

Allowed values for "indicatorGroup" and "IndicatorInterval" pair

  • FOMO
    • 5MIN - 5 min
    • 15MIN - 15 min
    • 60MIN - 1 hour
  • DIVER
    • 240MIN - 4 hours
  • TRENDS, TRENDS_CROSSING, OSCILLATORS
    • 1MIN - 1 min
    • 3MIN - 3 min
    • 5MIN - 5 min
    • 15MIN - 15 min
    • 30MIN - 30 min
    • 1HOUR - 1 hour
    • 2HOURS - 2 hours
    • 4HOURS - 4 hours
    • 6HOURS - 6 hours
    • 8HOURS - 8 hours
    • 12HOURS - 12 hours
    • 1DAY - 1 day
    • 3DAYS - 3 days

priceLevel
string
Enum: "NOTHING" "UPPER" "LOWER" "BOTH"

Price level

  • NOTHING - Does not use
  • UPPER - Upper price restriction
  • LOWER - Lower price restriction
  • BOTH - Upper and lower restrictions

priceLevelDown
float

Price level down

priceLevelUp
float

Price level up

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": {
    }
}

Update bot settings

Update bot settings

query Parameters
botId
required
integer <int64>

Bot Id

pairTitle
string
Example: pairTitle=USDT-BNB

Pair title

title
string

Title

strategy
string
Enum: "LONG" "SHORT"

Strategy

leverage
integer <int64>

Leverage

marginMode
string
Enum: "ISO" "CROSS"

Margin mode

typeTakeProfit
string
Enum: "LIMIT" "STOP-MARKET"

Type take profit

typeFirstOrder
string
Enum: "LIMIT" "MARKET"

Type first order

percentTakeProfit
float [ 0.01 .. 99.99 ]

Percent take profit

percentSafetyOrder
float [ 0.01 .. 99.99 ]

Percent safety order

volumeFirstOrder
float

Volume first order

volumeSafetyOrder
float

Volume safety order
Required if param "martingaleScale" is filled in

countOrderMax
integer [ 1 .. 50 ]

Count order max

martingaleScale
float [ 1.05 .. 2 ]

Martingale scale

dynamicStepScale
float [ 1.05 .. 2 ]

Dynamic step scale

cycleLimitScale
integer <int64>

Cycle limit scale

indicatorGroup
string
Enum: "NOTHING" "FOMO" "DIVER" "TRENDS" "TRENDS_CROSSING" "OSCILLATORS"

Group indicator

  • NOTHING - Does not use
  • FOMO - FOMO
  • DIVER - Diver
  • TRENDS - Moving Averages
  • TRENDS_CROSSING - Moving Average Crossovers
  • OSCILLATORS - Oscillators

indicatorName
string

Group indicator name
Required if param "indicatorGroup" is filled in, except "NOTHING"

Allowed values for "indicatorGroup" and "indicatorName" pair

  • FOMO
    • BTCUSDTPERP.small - USDT-BTC, small overbought/oversold
    • BTCUSDTPERP.classic - USDT-BTC, classic overbought/oversold
    • BTCUSDTPERP.deep - USDT-BTC, deep overbought/oversold
    • ETHUSDTPERP.small - USDT-ETH, small overbought/oversold
    • ETHUSDTPERP.classic - USDT-ETH, classic overbought/oversold
    • ETHUSDTPERP.deep - USDT-ETH, deep overbought/oversold
    • BNBUSDTPERP.small - USDT-BNB, small overbought/oversold
    • BNBUSDTPERP.classic - USDT-BNB, classic overbought/oversold
    • BNBUSDTPERP.deep - USDT-BNB, deep overbought/oversold
  • DIVER
    • diver - Divergence signal
  • TRENDS
    • EMA_5 - EMA, 5 period
    • SMA_5 - SMA, 5 period
    • EMA_10 - EMA, 10 period
    • SMA_10 - SMA, 10 period
    • EMA_20 - EMA, 20 period
    • SMA_20 - SMA, 20 period
    • EMA_30 - EMA, 30 period
    • SMA_30 - SMA, 30 period
    • EMA_50 - EMA, 50 period
    • SMA_50 - SMA, 50 period
    • EMA_100 - EMA, 100 period
    • SMA_100 - SMA, 100 period
  • TRENDS_CROSSING
    • EMA_CROSSING_5 - EMA crossover, 5 period
    • SMA_CROSSING_5 - SMA crossover, 5 period
    • EMA_CROSSING_10 - EMA crossover, 10 period
    • SMA_CROSSING_10 - SMA crossover, 10 period
    • EMA_CROSSING_20 - EMA crossover, 20 period
    • SMA_CROSSING_20 - SMA crossover, 20 period
    • EMA_CROSSING_30 - EMA crossover, 30 period
    • SMA_CROSSING_30 - SMA crossover, 30 period
    • EMA_CROSSING_50 - EMA crossover, 50 period
    • SMA_CROSSING_50 - SMA crossover, 50 period
    • EMA_CROSSING_100 - EMA crossover, 100 period
    • SMA_CROSSING_100 - SMA crossover, 100 period
  • OSCILLATORS
    • bbands - Bollinger Bands
    • MACD.s_crossing_macd_and_signal - MACD. Crossing MACD and signal lines
    • MACD.s_crossing_macd_and_zero_level - MACD. Crossing MACD and zero level
    • MACD.s_crossing_macdhist_and_zero_level - MACD. Histogram MACD, changing trend
    • BOP - Balance Of Power
    • stochastic.s_overbought_and_oversold_levels - Stochastic. Overbought and oversold levels
    • stochastic.s_crossing_k_and_d - Stochastic. Crossing K and D lines
    • stochastic_fast.s_overbought_and_oversold_levels - Stochastic Fast. Overbought and oversold levels
    • stochastic_fast.s_crossing_k_and_d - Stochastic Fast. Crossing K and D lines
    • RSI - RSI

indicatorInterval
string

Group indicator interval
Required if param "indicatorName" is filled in

Allowed values for "indicatorGroup" and "IndicatorInterval" pair

  • FOMO
    • 5MIN - 5 min
    • 15MIN - 15 min
    • 60MIN - 1 hour
  • DIVER
    • 240MIN - 4 hours
  • TRENDS, TRENDS_CROSSING, OSCILLATORS
    • 1MIN - 1 min
    • 3MIN - 3 min
    • 5MIN - 5 min
    • 15MIN - 15 min
    • 30MIN - 30 min
    • 1HOUR - 1 hour
    • 2HOURS - 2 hours
    • 4HOURS - 4 hours
    • 6HOURS - 6 hours
    • 8HOURS - 8 hours
    • 12HOURS - 12 hours
    • 1DAY - 1 day
    • 3DAYS - 3 days

priceLevel
string
Enum: "NOTHING" "UPPER" "LOWER" "BOTH"

Price level

  • NOTHING - Does not use
  • UPPER - Upper price restriction
  • LOWER - Lower price restriction
  • BOTH - Upper and lower restrictions

priceLevelDown
float

Price level down

priceLevelUp
float

Price level up

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": {
    }
}

Active deals

Active deals

query Parameters
accessId
required
integer <int64>
Example: accessId=33200

Access Id

exchange
required
string
Example: exchange=CRYPTORG_FUTURES

Exchange

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}

Deals history

Deals history

query Parameters
accessId
required
integer <int64>
Example: accessId=33200

Access Id

exchange
required
string
Example: exchange=CRYPTORG_FUTURES

Exchange

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}

Start new deal

Start new deal

query Parameters
botId
required
integer <int64>

Bot Id

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": "Command was sent"
}

Change Take Profit

Change Take Profit

query Parameters
dealId
required
integer <int64>

Deal Id

immediately
required
boolean

Immediately

newPercentOfTp
required
float

New Take Profit percentage

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": "Command was sent"
}

Complete deal

Complete deal

query Parameters
dealId
required
integer <int64>

Deal Id

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": "Command \"force complete deal\" was sent"
}

Cancel deal

Cancel deal

query Parameters
dealId
required
integer <int64>

Deal Id

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": "Command was sent"
}

Account information with positions

Account information with positions

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": {
    }
}

Pair

Cryptorg Pair

Futures currency pair list

Futures currency pair list

header Parameters
CTG-API-SIGNATURE
required
string

Signature

CTG-API-KEY
required
string

Cryptorg API Key

CTG-API-NONCE
required
string

Epoch time

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "errorMessage": "",
  • "data": [
    ]
}