Request

The requests is consisted of JSON Object and the response is also JSON Object. Requests are divided into ticket field, type field, and format field, and multiple type fields can be specified in one request. Please refer to Request method and format for ticket field and format field.

📘

Request format

[{Ticket Field},{Type Field},....,{Type Field},{Format Field}]

Type Field

In this field, you have to list the market data you want to receive.

"is_only_snapshot" and "is_only_realtime" fields are optional and both snapshot and real-time data will be received if they are omitted.

Field Name
Type
Description
Required
Default
typeStringdata type
ticker: Current market price
O
codesListMarket code list
*Must be requested in capital letters.
O
is_only_snapshotBooleanOnly provides snapshot dataXfalse
is_only_realtimeBooleanOnly provides real-time dataXfalse

Response

Field Name
Simplified Format (format: SIMPLE)
Description
TypeValue
typetyTypeStringticker : Current market price
codecdMarket ID (ex. SDG-BTC)String
opening_priceopOpening priceDouble
high_pricehpHigh priceDouble
low_pricelpLow priceDouble
trade_pricetpClosing price (Current price)Double
prev_closing_pricepcpPrevious closing price(UTC+00:00)Double
changecChange price type compared to the previous day’s closing price.StringRISE

EVEN

FALL
change_pricecpUnsigned change price compared to the previous day’s closing price.Double
signed_change_pricescpSigned change price compared to the previous day’s closing price.Double
change_ratecrUnsigned change price rate compared to the previous day’s closing price.Double
signed_change_ratescrSigned change price rate compared to the previous day’s closing price.Double
trade_volumetvLast trade volumeDouble
acc_trade_volumeatvAccumulated trade price (from UTC+00:00)Double
acc_trade_volume_24hatv24h24 hrs accumulated price.Double
acc_trade_priceatpAccumulated trade volume (from UTC+00:00)Double
acc_trade_price_24hatp24h24 hrs accumulated trade volumeDouble
trade_datetdtTrade date (UTC)StringyyyyMMdd
trade_timettmTrade time (UTC)StringHHmmss
trade_timestampttmsTrade timestamp (milliseconds)Long
ask_bidabOrder typeStringASK

BID
acc_ask_volumeaavAccumulated ask volumeDouble
acc_bid_volumeabvAccumulated bid volumeDouble
highest_52_week_priceh52wp52 week high priceDouble
highest_52_week_dateh52wdtDate of 52 week high price
Format: yyyy-MM-dd
Stringyyyy-MM-dd
lowest_52_week_pricel52wp52-week low priceDouble
lowest_52_week_datel52wdtDate of 52-week low price
Format: yyyy-MM-dd
Stringyyyy-MM-dd
trade_statustsTrade status
(*Deprecated)
String
market_statemsTrade statusStringPREVIEW : Deposit service
ACTIVE : Trading support available
DELISTED : Termination of trading support
market_state_for_iosmsfiTrade status
(*Deprecated)
String
is_trading_suspendeditsWhether the transaction is suspended (*Deprecated)Boolean
delisting_dateddDelisting dateDate
market_warningmwWhether the digital asset is marked as 'Investment Caution'StringNONE

CAUTION
timestamptmsTimestamp (millisecond)Long
stream_typestStream TypeStringSNAPSHOT

REALTIME

Example

Request

  • Current market price of SGD-BTC, SGD-ETH
[
  {
    "ticket": "test example"
  },
  {
    "type": "ticker",
    "codes": [
      "SGD-BTC",
      "SGD-ETH"
    ]
  },
  {
    "format": "DEFAULT"
  }
]

Response

{
  "type": "ticker",
  "code": "SGD-BTC",
  "opening_price": 37249,
  "high_price": 37645,
  "low_price": 36732,
  "trade_price": 36929,
  "prev_closing_price": 37235,
  "acc_trade_price": 5530.55648491,
  "change": "FALL",
  "change_price": 306,
  "signed_change_price": -306,
  "change_rate": 0.0082180744,
  "signed_change_rate": -0.0082180744,
  "ask_bid": "ASK",
  "trade_volume": 0.00006314,
  "acc_trade_volume": 0.149474,
  "trade_date": "20230830",
  "trade_time": "082105",
  "trade_timestamp": 1693383665811,
  "acc_ask_volume": 0.0197006,
  "acc_bid_volume": 0.1297734,
  "highest_52_week_price": 42710,
  "highest_52_week_date": "2023-07-06",
  "lowest_52_week_price": 21332,
  "lowest_52_week_date": "2022-11-21",
  "market_state": "ACTIVE",
  "is_trading_suspended": false,
  "delisting_date": null,
  "market_warning": "NONE",
  "timestamp": 1693383690031,
  "acc_trade_price_24h": 8320.40577449,
  "acc_trade_volume_24h": 0.22569412,
  "stream_type": "SNAPSHOT"
}
...
{
  "type": "ticker",
  "code": "SGD-ETH",
  "opening_price": 2347,
  "high_price": 2349,
  "low_price": 2306,
  "trade_price": 2334,
  "prev_closing_price": 2347,
  "acc_trade_price": 1532.79257748,
  "change": "FALL",
  "change_price": 13,
  "signed_change_price": -13,
  "change_rate": 0.0055389859,
  "signed_change_rate": -0.0055389859,
  "ask_bid": "BID",
  "trade_volume": 0.00206817,
  "acc_trade_volume": 0.65951195,
  "trade_date": "20230830",
  "trade_time": "082206",
  "trade_timestamp": 1693383726250,
  "acc_ask_volume": 0.34334474,
  "acc_bid_volume": 0.31616721,
  "highest_52_week_price": 2856,
  "highest_52_week_date": "2023-04-16",
  "lowest_52_week_price": 1479.5,
  "lowest_52_week_date": "2022-11-22",
  "market_state": "ACTIVE",
  "is_trading_suspended": false,
  "delisting_date": null,
  "market_warning": "NONE",
  "timestamp": 1693383750023,
  "acc_trade_price_24h": 4342.50350959,
  "acc_trade_volume_24h": 1.88473642,
  "stream_type": "REALTIME"
}