본문으로 건너뛰기

Premium

Premium data stream.

Connect​

websocat wss://api.datamaxiplus.com/ws/v1/premium -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

Subscribe​

  • method specifies the type of request.
  • params list represents symbols on which to compute premium between source and target exchanges that user wants to subscribe. The format of parameter is {sourceBase}-{sourceQuote}@{sourceExchange}@{sourceMarket}#{targetBase}-{targetQuote}@{targetExchange}@{targetMarket}#{currency}#{conversionBase} (e.g. "BTC-USDT@bybit@spot#BTC-KRW@upbit@spot#KRW#USDT").
  • The id uniquely identifies the subscription request.
{
  "method": "SUBSCRIBE",
  "params": [
    string
  ],
  "id": int32
}

Response​

Field (JSON key)Description
spSourceMidPrice — Latest price of the source exchange in requested currency.
Example: 45000
tpTargetMidPrice — Latest price of the target exchange.
Example: 45010
pdpPriceDiffPercent — Price difference % between source and target exchanges.
Example: 0.02
svSourceVolume — Trading volume of source exchange in last 24h in requested currency.
Example: 1000000
tvTargetVolume — Trading volume of target exchange in last 24h in requested currency.
Example: 1000000
shbSourceHighestBid — Highest bid from source exchange.
Example: 10001.43
slaSourceLowestAsk — Lowest ask from source exchange.
Example: 10001.43
sbd2pSourceBidDepth2p — +2% volume depth from source exchange.
Example: 10001.43
sad2pSourceAskDepth2p — −2% volume depth from source exchange.
Example: 10001.43
thbTargetHighestBid — Highest bid from target exchange.
Example: 10001.43
tlaTargetLowestAsk — Lowest ask from target exchange.
Example: 10001.43
tbd2pTargetBidDepth2p — +2% volume depth from target exchange.
Example: 10001.43
tad2pTargetAskDepth2p — −2% volume depth from target exchange.
Example: 10001.43
pmdPremiumDuration — Premium duration.
Example: 1
pdp5mPrice difference % between source and target 5m ago.
Example: 0.02
spdp5mPrice difference % of source exchange in last 5m.
Example: 0.02
tpdp5mPrice difference % of target exchange in last 5m.
Example: 0.02
pdp15mPrice difference % between source and target 15m ago.
Example: 0.02
spdp15mPrice difference % of source exchange in last 15m.
Example: 0.02
tpdp15mPrice difference % of target exchange in last 15m.
Example: 0.02
pdp30mPrice difference % between source and target 30m ago.
Example: 0.02
spdp30mPrice difference % of source exchange in last 30m.
Example: 0.02
tpdp30mPrice difference % of target exchange in last 30m.
Example: 0.02
pdp1hPrice difference % between source and target 1h ago.
Example: 0.02
spdp1hPrice difference % of source exchange in last 1h.
Example: 0.02
tpdp1hPrice difference % of target exchange in last 1h.
Example: 0.02
pdp4hPrice difference % between source and target 4h ago.
Example: 0.02
spdp4hPrice difference % of source exchange in last 4h.
Example: 0.02
tpdp4hPrice difference % of target exchange in last 4h.
Example: 0.02
pdp24hPrice difference % between source and target 24h ago.
Example: 0.02
spdp24hPrice difference % of source exchange in last 24h.
Example: 0.02
tpdp24hPrice difference % of target exchange in last 24h.
Example: 0.02
sbSource base token.
Example: BTC
sqSource quote token.
Example: USDT
tbTarget base token.
Example: BTC
tqTarget quote token.
Example: USDT
seSource exchange name.
Example: binance
teTarget exchange name.
Example: bybit
bidBase unique ID.
Example: bitcoin
smSource market type.
Example: spot
tmTarget market type.
Example: futures
dTimestamp (UTC ms).
Example: 1629780000000
stSource ticker timestamp (UTC ms).
Example: 1737525399882
ttTarget ticker timestamp (UTC ms).
Example: 1737525399882
scAMM source chain.
Example: ethereum
tcAMM target chain.
Example: ethereum
spaAMM source pool address.
Example: 0x1234567890123456789012345678901234567890
tpaAMM target pool address.
Example: 0x1234567890123456789012345678901234567890
tTransferable flag, null if unknown.
Example: true
sfrSource funding rate.
Example: 0.01
sfriSource funding rate interval (1 = 1h).
Example: 1
sndSource next distribution time (UTC ms).
Example: 1737525399882
tfrTarget funding rate.
Example: 0.01
tfriTarget funding rate interval (1 = 1h).
Example: 1
tndTarget next distribution time (UTC ms).
Example: 1737525399882
sfrtSource funding rate info timestamp (UTC ms).
Example: 1737525399882
tfrtTarget funding rate info timestamp (UTC ms).
Example: 1737525399882
nfrNet funding rate (considering interval).
Example: 0.01
fgFunding gap (without interval consideration).
Example: 0.01
smsSource margin supported (spot only).
Example: true
tmsTarget margin supported (spot only).
Example: true
{
"sp": float,
"tp": float,
"pdp": float,
"sv": float,
"tv": float,
"shb": float,
"sla": float,
"sbd2p": float,
"sad2p": float,
"thb": float,
"tla": float,
"tbd2p": float,
"tad2p": float,
"pmd": int,
"pdp5m": float,
"spdp5m": float,
"tpdp5m": float,
"pdp15m": float,
"spdp15m": float,
"tpdp15m": float,
"pdp30m": float,
"spdp30m": float,
"tpdp30m": float,
"pdp1h": float,
"spdp1h": float,
"tpdp1h": float,
"pdp4h": float,
"spdp4h": float,
"tpdp4h": float,
"pdp24h": float,
"spdp24h": float,
"tpdp24h": float,
"sb": string,
"sq": string,
"tb": string,
"tq": string,
"se": string,
"te": string,
"bid": string,
"sm": string,
"tm": string,
"d": int,
"st": int,
"tt": int,
"sc": string,
"tc": string,
"spa": string,
"tpa": string,
"t": bool,
"sfr": float,
"sfri": int,
"snd": int,
"tfr": float,
"tfri": int,
"tnd": int,
"sfrt": int,
"tfrt": int,
"nfr": float,
"fg": float,
"sms": bool,
"tms": bool
}