VOTE COINS ICOs HOST IEO/ICO new

SatoExchange Market Data API (CMC spec)

 

(Last Updated: 7 Oct 2019)

INTRODUCTION

This API reference includes technical documentation needed to to query market and assets data on SatoExchange and it fully adhere to the Coin Market Cap (CMC) standards seen on https://docs.google.com/document/d/1S4urpzUnO2t7DmS_1dc4EL4tgnnbTObPYXvDeBnukCg/mobilebasic.

SUMMARY

The public GET request endpoints are intended to allow access to market data. Endpoints return results in JSON format. Referenced in the /assets and /ticker endpoints is a Unified Cryptoasset ID (UCID). Please view this page for more information on the UCID.

 

STANDARDS AND CONVENTIONS

  1. No API authentication required on market endpoints.
  2. Full market queries available every 60 seconds.
  3. Data available in JSON format
  4. Versioning required to avoid breaking changes and this version is v3 (api/v3/asset, api/v3/asset, etc.)
  5. Content encoding: gzip supported for optimized data transfer.
  6. No region blocked API endpoints.

ENDPOINT OVERVIEW

All requests have root api link https://www.satoexchange.com/api/v3/

Name

Endpoint

Status

Description

Summary Endpoint

/summary

Available

Overview of market data for all tickers

Endpoint 1

/asset

Available

In depth details on crypto currencies available on the exchange.

Endpoint 2

/ticker

Available

24-hour rolling window price change statistics for all markets.

Endpoint 3

/orderbook

Available

Market depth of a trading pair. One array containing a list of ask prices and another array containing bid prices. Query for level 2 order book with full depth available as minimum requirement.

Endpoint 4

/trades

Available

Recently completed trades for a given market. 24 hour historical full trades available as minimum requirement.

 

ENDPOINT 1

ASSETS   https://www.satoexchange.com/api/v3/assets

The assets endpoint is to provide a detailed summary for each currency available on the exchange.

{  

   "BTC":{  

      "name":"Bitcoin",

      "unified_cryptoasset_id" :"1",

      "can_withdraw":"true",

      "can_deposit":"true",

      "min_withdraw":"0.01",

      "max_withdraw ":"100"

      "name":"bitcoin",

      "maker_fee":"0.01",

      "taker_fee":"0.01",

   },

   "ETH":{  

      "name":"Ethereum",

      "unified_cryptoasset_id":"1027",

      "can_withdraw":"false",

      "can_deposit":"false",

      "min_withdraw":"10.00",

      "max_withdraw ":"0.00"

      "maker_fee":"0.01",

      "taker_fee":"0.01",

   }

}

 

Assets response descriptions.

Name

  Type

  Status

Description

name

 string

Available

Name of cryptocurrency.

unified_cryptoasset_id

 integer

Available

Unique ID of cryptocurrency assigned by Unified Cryptoasset ID.

can_withdraw

  boolean

Available

Identifies whether withdraws are enabled or disabled.

can_deposit

     boolean

Available

Identifies whether deposits are enabled or disabled.

min_withdraw

 decimal

Available

Identifies the single minimum withdraw amount of a cryptocurrency.

max_withdraw

 decimal

Available

Identifies the single maximum withdraw amount of a cryptocurrency.

maker_fee

 decimal

Available

Fees applied when liquidity is added to the order book.

taker_fee

 decimal

Available

Fees applied when liquidity is removed from the order book.

 

ENDPOINT 2

TICKER   https://www.satoexchange.com/api/v3/ticker

The ticker endpoint is to provide a 24-hour pricing and volume summary for each market pair available on the exchange.

{  

   "BTC_USDT":{  

      "base_id":"1",

      "quote_id":"825",

      "last_price":"10000",

      "quote_volume":"20000",

      "base_volume":"2",

      "isFrozen":"0"

   },

   "LTC_BTC":{  

      "base_id":"2",

      "quote_id":"1",

      "last_price":"0.00699900",

      "base_volume":"20028,526",

      "quote_volume":"279594",

      "isFrozen":"0"

   }

}

 

Ticker response descriptions.

Name

  Type

Status

Description

base_id

  integer

Available

The quote pair Unified Cryptoasset ID.

quote_id

  integer

Available

The base pair Unified Cryptoasset ID.

last_price

  decimal

Available

The price of the last executed order

base_volume

  decimal

Available

24 hour trading volume in base pair volume

quote_volume

  decimal

Available

24 hour trading volume in quote pair volume

isFrozen

  integer

Available

Indicates if the market is currently enabled (1) or disabled (0).

 

 

ENDPOINT 3

ORDERBOOK   https://www.satoexchange.com/api/v3/orderbook/market_pair

The order book endpoint is to provide a complete level 2 order book (arranged by best asks/bids) with full depth returned for a given market pair.

Parameters:

Name

Type

Status

  Description

market_pair

string

Required

  A pair such as LTC_BTC

depth

int

Optional

  Orders depth quantity:[0,5,10,20,50,100,500]

  Not defined or 0 = full order book

level

int

Optional

  Level 1 Only the best bid and ask.

  Level 2 Arranged by best bids and asks.

  Level 3 Complete order book, no aggregation.

 

 

{  

   "timestamp":"1566359163",

   "bids":[  

      [  

         "12462000",

         "0.04548320"

      ],

      [  

         "12457000",

         "3.00000000"

      ]

   ],

   "asks":[  

      [  

         "12506000",

         "2.73042000"

      ],

      [  

         "12508000",

         "0.33660000"

      ]

   ]

}

 

Order book response descriptions.

Name

  Type

  Status

Description

timestamp

  timestamp

  Available

Unix timestamp in milliseconds for when the last updated time occurred.

bids

  decimal

  Available

An array containing 2 elements. The offer price and quantity for each bid order.

asks

  decimal

  Available

An array containing 2 elements. The ask price and quantity for each ask order.

 

 

ENDPOINT 4

TRADES   https://www.satoexchange.com/api/v3/trades/market_pair

The trades endpoint is to return data on all recently completed trades for a given market pair.

Parameters:

Name

Type

Status

  Description

market_pair

string

Required

  A pair such as LTC_BTC.

type/side

string

Optional

 Query buy side or sell side only.

 

[  

   {        

      "tradeID":3523643,

      "price":"0.01",

      "base_volume":"569000",

      "quote_volume":"0.01000000",

      "trade_timestamp":"1566360780",

      "type":"sell"

   }

]

 

Trades response descriptions.

Name

  Type

Status

Description

trade_id

  integer

Available

A unique ID associated with the trade for the currency pair transaction

 Note: Unix timestamp does not qualify as trade_id.

price

  decimal

Available

Transaction price in base pair volume.

base_volume

  decimal

Available

Transaction amount in base pair volume.

quote_volume

  decimal

Available

Transaction amount in quote pair volume.

trade_timestamp

  timestamp

Available

Unix timestamp in milliseconds for when the transaction occurred.

type

  string

Available

Used to determine whether or not the transaction originated as a buy or sell.

  Buy - Identifies an ask was removed from the order book.

  Sell - Identifies a bid was removed from the order book.

CodePriceVol
DMME0.000000030.00347177-57.14%
BTCA0.000000010.001158630%
TRCX0.000000020.0010%
NANJ0.000000010.000920%
BTFC0.000001000.0007980%
XRP0.000022000.000794820%
XLM0.000006500.000714870%
UBEX0.000000100.000545480%
HELX0.000000020.000458120%
1MT0.000012000.00037430%
BRAT0.000000010.000343520%
DCN0.000000010.00029880%
STQ0.000000010.000280%
nCoV0.000000010.000250%
ETH0.070000000.000135150%
GFNCASH0.000000010.000111440%
WAVES0.000799570.00010%
UM10.000000010.00010%
VN0.000001850.00010%
TRM0.000000010.00010%
BCH0.0105000100%
XQR0.0000001000%
ETC0.0006600000%
FGP0.0000028900%
OMG0.0000000000%
TRX0.0000018000%
AXAI0.0000000100%
KIN0.0000000200%
DENT0.0000005900%
AE0.0000000000%
LTC0.0045000000%
BEFX0.0000000100%
DOGE0.0000999800%
CPC0.0000004500%
SWAT0.0000000100%
INFO0.0000000400%
DP0.0000003000%
XTZ0.0003600000%
BTT0.0000000600%
WWTC0.0000000000%
PYRO0.0000000200%
XAUT0.0000000000%
BLNC0.0000000100%
DGB0.0000015100%
XRT0.0000000300%
SATX0.0000001300%
KAYI0.0000000100%
JST0.0000007500%
LINK0.0006500000%
GRT0.0002942000%
HELP0.0000030000%
WLLO0.0000000000%
MOTA0.0000009400%
B1P0.0000005900%
SCC0.0000364100%
MMO0.0000004800%
CLOUT0.0000000000%
LAQ0.0000000100%
CST0.0000000000%
EOC0.0002300000%
WIZ0.0000100000%
DPC0.0000000000%
C2O0.0000324300%
VGC0.0000099900%
GCG0.0000000100%
BTCGW0.0000000400%
GCC0.0000000000%
BTCP0.0000319700%
WEBN0.0000000100%
FREE0.0000000100%
BNB0.0400000000%
ZRX0.0000333300%
BAT0.1333000000%
C4C0.0000000100%
SWAP0.0000000000%
CLDX0.0000000100%
BNC0.0000045000%
iC2S0.0000000100%
BTB0.0000001700%
A0.0000004000%
DET0.0000000000%
KNT0.0000000100%
ELD0.0000000000%
TICO0.0000000900%
SRK0.0000003000%
CodePriceVol
BTC/USDT64999.70700000118.085468590%
BUSD/USDT0.920000010.920000010%
MOTA/USDT0.032023900.565694550%
DOGE/USDT0.899980000.30%
GRT/USDT12.500000000.11250%
BCH/USDT1500.000000000.0271050%
MMO/USDT0.001000000.000381930%
BTC/USDC0.0000000000%
BTC/TUSD9200.0000000000%
ETH/USDT4999.7920000000%
ETH/USDC911.0000000000%
ETH/TUSD0.0000000000%
SATX/USDT0.0047000000%
LTC/USDT0.0000000000%
TRX/USDT0.1499987900%
XLM/USDT0.0000000000%
XTZ/USDT0.0000000000%
XRP/USDT1.9999998900%
XAUT/USDT0.0000000000%
DGB/USDT0.0000000000%
WAVES/USDT0.0000000000%
VN/USDT0.1299990000%
TW/USDT0.0000120700%
CST/USDT0.0000000000%
BNB/USDT999.0000000000%
ANI/USDT0.0100000100%
WIZ/USDT0.0000000000%
BNB/BUSD100.1000000000%
ZOL/USDT0.0001000000%
BTCV/USDT0.0960000000%
HUB/USDT0.0000000000%
CLUE/USDT0.0000004700%
SHIB/USDT0.0000000000%
ELON/USDT0.0000000000%
ASS/USDT0.0000000100%
CodePriceVol
HELX0.000000390.08643959-15.21%
FREE0.000000010.0250%
WEBN0.000000010.01250%
C4C0.000000010.004807860%
BTCA0.000000150.004468880%
BTCGW0.000000390.0039040%
DGB0.000018020.002757060%
BNC0.000000100.002639890%
TRM0.000000010.002210%
PYRO0.000000010.00170785-75%
nCoV0.000000010.001611830%
ECR0.000000010.0010%
VN0.000002010.000568830%
BRAT0.000000020.00050%
XRT0.000000010.00050%
DENT0.000001200.000464350%
UM10.000000020.000354160%
XPAT0.000000090.000352580%
ETHMNY0.000000020.000210930%
TICO0.000000680.00020%
SWAT0.000000010.000170%
FGP0.000079960.000119940%
KIN0.000000120.00010%
DOGE0.000178500.00010%
XQR0.0000001900%
GRVC0.0000015000%
TRCX0.0000001900%
GEN0.0000013000%
BEFX0.0000000000%
BCH1.0000001100%
CPC0.0000055600%
XRP0.0003613500%
SRK0.0000008100%
ETC0.5000000000%
OMG0.0000000000%
TRX0.0006999300%
DCN0.0000007900%
DP0.0000000000%
XTZ1000.0000000000%
NANJ0.0000000300%
AE0.0000000000%
LTC0.1579882500%
EVI0.0000000200%
TORR0.0000000100%
BTT0.0000006600%
WWTC0.0000000000%
XAUT5.0000000000%
BLNC0.0000000100%
FTH0.0000007400%
ETD0.0000070000%
REW0.0000015000%
SATX0.0000018400%
KAYI0.0000020300%
JST0.0020000000%
LINK0.0000000000%
WAVES0.0166483500%
GRT0.0042069000%
1MT0.0017799700%
BTRS0.2990000000%
TTO0.0000014500%
CLOUT0.0000000000%
NEWS0.0007000000%
LAQ0.0000001000%
CST0.0000000000%
EOC0.0000000000%
WIZ0.0001000000%
GCG0.0000000000%
GCC0.0000000000%
STQ0.0000001500%
UBEX0.0000024900%
BTCP0.0000000000%
BNB0.8200000000%
ZRX0.0004200000%
BAT0.0005650000%
CLO0.0000149100%
XLM0.0000822000%
CLDX0.0000045000%
BTB0.0000099600%
A0.0000011800%
DET0.0000000000%
GFNCASH0.0000001300%
ELD0.0000027000%
CodePriceVol
LTC399998.756100002429.439417460%
HELX0.53090000475.055970440%
XTZ835.0000000000%
BTT0.0001850500%
DGB200.0000000000%
DOGE350.0000000000%
BCH1000000.0000000000%
XRP9999.7499990000%
ETC1258.0000000000%
TRX149.9999999900%
WAVES6497.6939000000%
BTCP100000.0000000000%
HUB0.0000000000%
SHIB0.0000000000%
BNB1350.0000000000%
ZRX100.0000000000%
BAT10.5200000900%
XLM49899.0000000000%
BTB2.0000000000%
CodePriceVol
EVI/DOGE0.0000071811.69089123-28.27%
TICO/DOGE0.0315798911.0050%
WAVES/DOGE42.120004000.840382950%
KAYI/DOGE0.000010040.009099620%
ECR/DOGE0.0000989900%
CPC/DOGE0.7000000000%
INFO/DOGE5.0000000000%
DP/DOGE0.0065000000%
AXAI/DOGE0.1690849900%
TORR/DOGE0.0000363500%
LTC/DOGE0.0000000000%
BCH/DOGE42000.0000000000%
BRAT/DOGE0.0009000000%
XRP/DOGE2.0000001100%
BTCA/DOGE0.0191000000%
DENT/DOGE0.3690000000%
REW/DOGE0.0000000000%
DCN/DOGE0.0000000000%
NEWS/DOGE2.9000000000%
STQ/DOGE0.0000000000%
WLLO/DOGE0.0001435800%
VGC/DOGE0.0500000000%
BTCGW/DOGE0.0049999700%
WHX/TRX0.0010100100%
ANI/BNB0.0001600000%
WHXC/TRX0.0000001300%
WHXC/WHX0.0000000000%
SHIB/DOGE0.0000225000%
ZRX/DOGE0.0000000000%
XLM/DOGE4.8000000000%
iC2S/DOGE0.0002990000%
XPAT/DOGE0.1189500000%

Troll

  • RULES
Dear members,We must tender our apologies for this process taking longer than we have expected.However, we are glad to bring to your awareness that the... Read more
We killed the rat but it ate the cheeseWe will start by summarizing the situation and then give more details as we move on.The issue... Read more
Last Updated: 7th April 2021Dear members and the general public,We have all put our best into making SatoExchange the best exchange of the people, for... Read more
Zolan Trade CompetitionTrade & Win from a pool of 300,000 ZOL participating in the trade competition on SatoExchange.ZOLAN token (ZOL)SatoexchangeZOL/USDThttps://www.satoexchange.com/market/ZOL/USDT/Free ZOLAN tokens for 3 winners3... Read more