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.
"isOnlySnapshot" and "isOnlyRealtime" fields are optional and both snapshot and real-time data will be received if they are omitted.
Field Name | Type | Description | Required | Default |
|---|---|---|---|---|
| type | String | data type - ticker: Current market price | O | |
| codes | List | Market code list *Must be requested in capital letters. | O | |
| isOnlySnapshot | Boolean | Only provides snapshot data | X | false |
| isOnlyRealtime | Boolean | Only provides real-time data | X | false |
Response
| Field Name | Simplified Format (format: SIMPLE) | Description | Type | Value |
|---|---|---|---|---|
| type | ty | Type | String | ticker : Current market price |
| code | cd | Market ID (ex. SDG-BTC) | String | |
| opening_price | op | Opening price | Double | |
| high_price | hp | High price | Double | |
| low_price | lp | Low price | Double | |
| trade_price | tp | Closing price (Current price) | Double | |
| prev_closing_price | pcp | Previous closing price(UTC+00:00) | Double | |
| change | c | Change price type compared to the previous day’s closing price. | String | RISEEVENFALL |
| change_price | cp | Unsigned change price compared to the previous day’s closing price. | Double | |
| signed_change_price | scp | Signed change price compared to the previous day’s closing price. | Double | |
| change_rate | cr | Unsigned change price rate compared to the previous day’s closing price. | Double | |
| signed_change_rate | scr | Signed change price rate compared to the previous day’s closing price. | Double | |
| trade_volume | tv | Last trade volume | Double | |
| acc_trade_volume | atv | Accumulated trade price (from UTC+00:00) | Double | |
| acc_trade_volume_24h | atv24h | 24 hrs accumulated price. | Double | |
| acc_trade_price | atp | Accumulated trade volume (from UTC+00:00) | Double | |
| acc_trade_price_24h | atp24h | 24 hrs accumulated trade volume | Double | |
| trade_date | tdt | Trade date (UTC) | String | yyyyMMdd |
| trade_time | ttm | Trade time (UTC) | String | HHmmss |
| trade_timestamp | ttms | Trade timestamp (milliseconds) | Long | |
| ask_bid | ab | Order type | String | ASKBID |
| acc_ask_volume | aav | Accumulated ask volume | Double | |
| acc_bid_volume | abv | Accumulated bid volume | Double | |
| highest_52_week_price | h52wp | 52 week high price | Double | |
| highest_52_week_date | h52wdt | Date of 52 week high price Format: yyyy-MM-dd | String | yyyy-MM-dd |
| lowest_52_week_price | l52wp | 52-week low price | Double | |
| lowest_52_week_date | l52wdt | Date of 52-week low price Format: yyyy-MM-dd | String | yyyy-MM-dd |
| trade_status | ts | Trade status *deprecated | String | |
| market_state | ms | Trade status | String | PREVIEW : Deposit service ACTIVE : Trading support available DELISTED : Termination of trading support |
| market_state_for_ios | msfi | Trade status *deprecated | String | |
| is_trading_suspended | its | Whether the transaction is suspended | Boolean | |
| delisting_date | dd | Delisting date | Date | |
| market_warning | mw | Whether the digital asset is marked as 'Investment Caution' | String | NONECAUTION |
| timestamp | tms | Timestamp (millisecond) | Long | |
| stream_type | st | Stream Type | String | SNAPSHOTREALTIME |
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"
}