Authentication
Public Endpoints
Private Endpoints
Models
The supported model types between Server and Client are given in the following tables.
- The Code in the table is the type value of the model. (The number on the top left of the model)
- ShortName is the model code (which we use this way) that can be used as a variable, class, or enum name.
- Mixes of types (letter code at the top right of the model) and usage patterns are as follows:
- P: general packages. Contains type. There is no need to subscribe or login to any channel to receive or send.
- U: General packages that are accessed only by logged-in users. These packages also do not have a /channel and subscription connection.
- A: Packages received only when subscribed to events on the channels. In the models of these packages, besides the type variable, there are string variables named channel and event.
To access token information, press F12 after logging into our SSO site.
You can get token information by following the steps Storage > Local Storage > btcUser
- You can use
https://api.btcturk.com/api/v2/token/refreshendpoint to renew the token. - After sending a user login message to channel 111, p-coded messages are automatically received
You can use HMAC authentication instead of Token to establish WebSocket connection.
Code Example for connecting channels
1
import json
2
import pprint
3
import time
4
import websocket
5
6
try:
7
import thread
8
except ImportError:
9
import _thread as thread
10
11
def on_message(ws, message):
12
data = json.loads(message)
13
pprint.pprint(data)
14
def on_error(ws, error):
15
print(error)
16
def on_close(ws):
17
print("### closed ###")
18
def on_open(ws):
19
def run(*args):
20
time.sleep(1)
21
message = [
22
151,
23
{
24
"type": 151,
25
"channel": 'CHANNEL_NAME_HERE',
26
"event": 'PAIR_NAME_HERE',
27
"join": True
28
}
29
]
30
ws.send(json.dumps(message))
31
thread.start_new_thread(run, ())
32
33
34
if __name__ == "__main__":
35
websocket.enableTrace(True)
36
ws = websocket.WebSocketApp(
37
"wss://ws-feed-pro.btcturk.com/",
38
on_message=on_message,
39
on_error=on_error,
40
on_close=on_close)
41
ws.on_open = on_open
42
ws.run_forever()
Copied!
Channel 100 (Result)
A message sent from the server to the client. These are model-free results returned from requests sent to the server. For example, UserLogin, Subscription, and so on.
100
Result
P
Type
number
Model type
ID
number
Id value of the model being processed. It is used in some Result models. The value can be 0 when not in use.
Ok
boolean
Transaction success
message
string
transaction message. It usually contains short codes for the transaction. It should not be shown to the end user. For example, the value returned as subscription result: “join | trade: BTCTRY” is similar.
Channel 101 (Request)
Extra requests sent to the server. For example, the Request model is sent when the last operations list is requested again.
101
Request
P
type
number
Model type
code
number
The request code. Designed in the same way as possible with package types. These request codes are listed at the end of the document. For example, the client must send this code value 421 (model type of final operations) to request that the last transactions be sent back to it.
channel
string
If the request is sent over a particular channel, this value must be written to the channel name. For non-channel requests, null can be sent.
event
string
If the request is sent over a particular event, this value must be written to the name of the event. For non-event requests, null can be sent.
Channel 111 (UserLogin)
A message sent from the client to the server. User input model.
Code Example
1
message = [
2
111,
3
{
4
"type": 111,
5
"id": USER_ID_HERE, #number
6
"token": "ACCESS_TOKEN_INFORMATION_HERE",
7
"username": "YOUR_MAIL_HERE"
8
}
9
]
Copied!
111
UserLogin
P
type
number
Model type
ID
number
The id value of the user. The server checks for its equality with the value read from the Token. If you want to make a guest login notification, send 0 to this value. (Guest login notification is not mandatory in the system)
username
string
User name. E-mail address for BtcTurk. Giriş guest. Should be written in the guest entrance notifications.
token
string
The current token value of the user from SSO. Null must be sent in guest notifications.
app
string
Application name: “pro” or “easy”
platform
string
User's operating system or browser information: “android”, “ios”, “windows”, “linux”
Channel 112 (UserLoginResult)
A message sent from the server to the client. This is the answer to the user input model. It is exactly the same as the Result model.When a request is made with a JSON web token, user login response is received from channel 112.
112
UserLoginResult
P
Channel 113 (UserLogout)
It is a message that is sent back from client to server and back from server to client. The user is the output model. After this model is taken, the server will terminate the socket connection.
113
UserLogout
U
type
number
Model type
ID
number
User Id
Channel 114 (UserLoginResult)
A message sent from the server to the client. This is the answer to the user input model. It is exactly the same as the Result model.When a request is made with a HMAC Authentication, user login response is received from channel 114.
114
UserLoginResult
P
Channel 151 (Subscription)
A message sent from the client to the server. A model sent to subscribe to or unsubscribe from an event on a channel. Messages related to subscribed events are continuously sent to the user.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'CHANNEL_NAME_HERE',
6
"event": 'PAIR_NAME_HERE',
7
"join": True
8
}
9
]
Copied!
151
Subscription
P
type
number
Model type
channel
string
The name of the channel. For example; trade, orderbook, ticker etc.
event
string
speak event name event name. Event names are often used as “all” or upper-case as pair name (eg BTCTRY, ETHTRY).
join
boolean
If true, it means that you want to subscribe, if false, you can unsubscribe.
Channel 201 (BalanceUpdated)
The model sent by the server when the user's balance changes for any reason (confirmation, withdrawal request, deposit request, request confirmations, etc.). When this message is received, the user's balance must be updated from the API endpoint.
201
BalanceUpdated
U
type
number
Model type
UserID
number
User Id
payload
string
Transaction description. For informational purposes.
Channel 401 (TickerAll)
A message sent from the server to the client. It is the model of all ticker data belonging to all Pairs.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'ticker',
6
"event": 'all',
7
"join": True
8
}
9
]
Copied!
401
TickerAll
C
type
number
Model type
items
TickerPair []
An array of type TickerPair. The only difference is that there is no type variable in every TickerPair model. The TickerPair model is described below.
Channel 402 (TickerPair)
A message sent from the server to the client. It is only a model of all ticker data for a particular Pair.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'ticker',
6
"event": 'all',
7
"join": True
8
}
9
]
Copied!
402
TickerPair
C
type
number
Model type
PS
string
Pair Symbol. For example; BTCTRY
H
string
High. Highest price in the last 24 hours.
L
string
Lower. The lowest price in the last 24 hours.
La
string
Last. The price of the last transaction.
SHE IS
string
Open. Price of the first transaction of the day
V
string
Volume. Volume.
AV
string
Average. Average price.
D
string
Daily. Daily change amount.
DS
string
Denominator Symbol. For example BTCTRY TRY.
NS
string
Numerator Symbol. For example BTCTRY for BTC.
PID
number
Pair Id value.
NPr
number
Numerator precision value. For example BTC 8
Dpr
number
Denominator precision value. For example TRY 2
O
number
Pair's display sequence.
B
string
Bidar. Best purchase order price.
A
string
Love. Best selling order price.
DP
string
Daily percent. 24-hour exchange rate.
Channel 421 (TradeList)
A message sent from the server to the client. This is the list of all recent transactions of the specified Pair.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'trade',
6
"event": 'BTCTRY',
7
"join": True
8
}
9
]
Copied!
421
TradeList
C
type
number
Model type
channel
string
Message channel
event
string
The name of the event to which the message was delivered.
symbol
string
Pair symbol. For example; BTCTRY
items
TradeSingle []
An array in the list that contains a transaction log. The TradeSingle model is described below. The TradeSingle models in the TradeList model do not contain the PS and type variables.
Channel 422 (TradeSingle)
A message sent from the server to the client. It is a single trade data of the specified Pair. This data is sent as it occurs.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'trade',
6
"event": 'BTCTRY',
7
"join": True
8
}
9
]
Copied!
422
TradeSingle
C
type
number
Model type
PS
number
Pair Symbol. For example; BTCTRY.
A
string
Amount. The amount of the transaction.
S
number
Trade Side. Shows the status of the order.
- 0: Buy
- 1: Sell
D
number
Date. Transaction date. UnixTime is the value in milliseconds.
P
string
Price. The price at which the transaction was made.
I
string
The unique number of the transaction. (Uniqueness is valid only in its own pairi)
Channel 431 (OrderBookFull)
A message sent from the server to the client. It is the entire order book model of a particular Pair.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'orderbook',
6
"event": 'BTCTRY',
7
"join": True
8
}
9
]
Copied!
431
OrderBookFull
C
type
number
Model type
CS
number
ChangeSet. Change number. It comes in the form of sequential values. There is no control at this time.
PS
string
Pair Symbol value. For example; BTCTRY
AO
Order []
List of sales orders. The Order object contains two variables: A, amount, and transaction quantity. P is the price, the transaction price.
BO
Order []
List of purchase orders.
Channel 432 (OrderBookDifference)
A message sent from the server to the client. Sends order book data of only a particular Pair's changes. The user must have previous order book data to use this model. This data is sent automatically from the server when the event is subscribed.
Changingord is
- CP: Orders are transaction type.
- 0: Updated
- 1: New added
- 3: Deleted
- P: Order price value.
- A: Orders is the quantity.
Code Example
1
message = [
2
151,
3
{
4
"type": 151,
5
"channel": 'obdiff',
6
"event": 'BTCTRY',
7
"join": True
8
}
9
]
Copied!
432
OrderBookDifference
C
type
number
Model type
CS
number
ChangeSet. Change number. It comes in the form of sequential values. There is no control at this time.
PS
string
Pair Symbol value. For example; BTCTRY
CP
number
Changing Process of pair
AO
ChangingOrder []
List of sales orders. The Order object contains two variables: A, amount, and transaction quantity. P is the price, the transaction price.
BO
ChangingOrder []
List of purchase orders.
Channel 441 (UserOrderMatch)
It is the model that contains the details of this process, which is sent from the server to the user when an order of the connected user is executed.
441
UserOrderMatch
U
type
number
Model type
id
number
Id value of the model being processed.
user
boolean
The id of the user being processed.
isBid
string
True if the transaction is buying or false if the transaction is buying.
method
number
transaction method. 0: limit, 1: market, 2: stop limit
pair
number
pair id value of the transaction
symbol
string
The pair symbol value of the operation. For example; BTCTRY
amount
string
The amount of the transaction.
price
string
The price at which the transaction occurred.
clientId
string
ClientId of the order
timestamp
date
Server time of the order
Channel 451 (OrderInsert)
A message sent from the server to the client. When a user's order is added to the system, it is the model sent to the user. Newly added orders will be sent with the model. When this model is received from the server, the user's orders can be updated from the endpoint.
451
orderınsert
U
type
number
Model type
pairId
number
The pair id value of the order
symbol
string
The pair symbol value of the order
ID
number
Order Id value
method
number
Type of order (0: limit, 1: market, 2: stop limit)
userId
number
The Id value of the user who issued the order
price
string
Price of the order
amount
string
Amount of order
numLeft
number
total crypto amount
denomLeft
number
total order amount (TRY, USDT, BTC)
newOrderClientId
string
ClientId of the order
Channel 452 (OrderDelete)
A message sent from the server to the client. When a user's order is deleted from the system, it is the model that is sent to the user. Deleted orders with model will be sent. When this model is received from the server, the user's orders can be updated from the endpoint. The model is the same as the OrderInsert model.
452
OrderDelete
U
Channel 453 (OrderUpdate)
A message sent from the server to the client. This is the model sent to the user when an order of the user is updated in the system. Orders updated with the model will be sent. When this model is received from the server, the user's orders can be updated from the endpoint. The model is the same as the OrderInsert model.
453
OrderUpdate
U
Last modified 1mo ago
Copy link
Contents
Code Example for connecting channels
Channel 100 (Result)
Channel 101 (Request)
Channel 111 (UserLogin)
Channel 112 (UserLoginResult)
Channel 113 (UserLogout)
Channel 114 (UserLoginResult)
Channel 151 (Subscription)
Channel 201 (BalanceUpdated)
Channel 401 (TickerAll)
Channel 402 (TickerPair)
Channel 421 (TradeList)
Channel 422 (TradeSingle)
Channel 431 (OrderBookFull)
Channel 432 (OrderBookDifference)
Channel 441 (UserOrderMatch)
Channel 451 (OrderInsert)
Channel 452 (OrderDelete)
Channel 453 (OrderUpdate)