AnnouncementsGuidesAPI ReferenceSupport
API Reference
Start typing to search…

Ticker

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}][{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

type

String

data type
- ticker: Current market price

O

codes

List

Market code list
*Must be requested in capital letters.

O

is_only_snapshot

Boolean

Only provides snapshot data

X

false

is_only_realtime

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

RISE\
EVEN\
FALL

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

ASK\
BID

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 (*Deprecated)

Boolean

delisting_date

dd

Delisting date

Date

market_warning

mw

Whether the digital asset is marked as 'Investment Caution'

String

NONE\
CAUTION

timestamp

tms

Timestamp (millisecond)

Long

stream_type

st

Stream Type

String

SNAPSHOT\
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"
}