Get ticker by symbol
GET/tickers/:symbol
Get market data for contract or index by symbol
Request
Path Parameters
Possible values: Value must match regular expression [A-Z0-9_.]+
Market symbol.
Responses
- 200
- 404
- application/json
- Schema
- Example (from schema)
- success
Schema
- ContractTickerJson
- SpotTickerJson
- For a call: markPrice - ( max ( Underlying - StrikePrice , 0) )
- For a put: markPrice - ( max ( StrikePrice - Underlying , 0) )
ticker object
For futures: The price of the last fill
For indices: The last calculated value
The date and time at which last was observed.
The symbol of the Futures.
For futures: Currently can be 'perpetual', 'month' or 'quarter'. Other tags may be added without notice
For indices: Not returned because N/A
For futures: The currency pair of the instrument
For indices: Not returned because N/A
For futures: The price to which Kraken Futures currently marks the Futures for margining purposes
For indices: Not returned because N/A
For futures: The price of the current best bid
For indices: Not returned because N/A
For futures: The size of the current best bid
For indices: Not returned because N/A
For futures: The price of the current best ask
For indices: Not returned because N/A
For futures: The size of the current best ask
For indices: Not returned because N/A
For futures: The sum of the sizes of all fills observed in the last 24 hours
For indices: Not returned because N/A
For futures: The sum of the size * price of all fills observed in the last 24 hours
For indices: Not returned because N/A
For futures: The current open interest of the instrument
For indices: Not returned because N/A
For futures: The price of the fill observed 24 hours ago
For indices: Not returned because N/A
For futures: The highest fill price observed in the last 24 hours
For indices: Not returned because N/A
For futures: The lowest fill price observed in the last 24 hours
For indices: Not returned because N/A
For futures: The size of the last fill
For indices: Not returned because N/A
For options: the mark price less the how much the option would be worth if exercised now, i.e.:
Not returned for other contract types or indicies because N/A.
The current absolute funding rate.
The estimated next absolute funding rate.
True if the market is suspended, False otherwise.
The 24h change in price (%)
For futures: The price of the last fill
For indices: The last calculated value
The date and time at which last was observed.
The symbol of the index.
Possible values: [success
]
Server time in Coordinated Universal Time (UTC)
{
"ticker": {
"last": 0,
"lastTime": "string",
"symbol": "string",
"tag": "string",
"pair": "string",
"markPrice": 0,
"bid": 0,
"bidSize": 0,
"ask": 0,
"askSize": 0,
"vol24h": 0,
"volumeQuote": 0,
"openInterest": 0,
"open24h": 0,
"high24h": 0,
"low24h": 0,
"lastSize": 0,
"extrinsicValue": 0,
"fundingRate": 0,
"fundingRatePrediction": 0,
"suspended": true,
"indexPrice": 0,
"postOnly": true,
"change24h": 0
},
"result": "success",
"serverTime": "2020-08-27T17:03:33.196Z"
}
{
"result": "success",
"ticker": {
"tag": "perpetual",
"pair": "XBT:USD",
"symbol": "pi_xbtusd",
"markPrice": 30209.9,
"bid": 8634,
"bidSize": 1000,
"ask": 49289,
"askSize": 139984,
"vol24h": 15304,
"volumeQuote": 40351.34,
"change24h": 1.9974017538161748,
"openInterest": 149655,
"open24h": 49289,
"indexPrice": 21087.8,
"last": 49289,
"lastTime": "2022-06-17T10:46:35.705Z",
"lastSize": 100,
"suspended": false,
"fundingRate": 1.18588737106e-7,
"fundingRatePrediction": 1.1852486794e-7,
"postOnly": false
},
"serverTime": "2022-06-17T11:00:31.335Z"
}
Contract could not be found
- application/json
- Schema
- Example (from schema)
Schema
accountInactive
: The Futures account the request refers to is inactiveapiLimitExceeded
: The API limit for the calling IP address has been exceededauthenticationError
: The request could not be authenticatedinsufficientFunds
: The amount requested for transfer is below the amount of funds availableinvalidAccount
: The Futures account the transfer request refers to is invalidinvalidAmount
: The amount the transfer request refers to is invalidinvalidArgument
: One or more arguments provided are invalidinvalidUnit
: The unit the transfer request refers to is invalidJson Parse Error
: The request failed to pass valid JSON as an argumentmarketUnavailable
: The market is currently unavailablenonceBelowThreshold
: The provided nonce is below the thresholdnonceDuplicate
: The provided nonce is a duplicate as it has been used in a previous requestnotFound
: The requested information could not be foundrequiredArgumentMissing
: One or more required arguments are missingServer Error
: There was an error processing the requestUnavailable
: The endpoint being called is unavailableunknownError
: An unknown error has occurred
Possible values: [accountInactive
, apiLimitExceeded
, authenticationError
, insufficientFunds
, invalidAccount
, invalidAmount
, invalidArgument
, invalidUnit
, Json Parse Error
, marketUnavailable
, nonceBelowThreshold
, nonceDuplicate
, notFound
, requiredArgumentMissing
, Server Error
, Unavailable
, unknownError
]
Possible values: [accountInactive
, apiLimitExceeded
, authenticationError
, insufficientFunds
, invalidAccount
, invalidAmount
, invalidArgument
, invalidUnit
, Json Parse Error
, marketUnavailable
, nonceBelowThreshold
, nonceDuplicate
, notFound
, requiredArgumentMissing
, Server Error
, Unavailable
, unknownError
]
Error description.
Possible values: [error
]
Server time in Coordinated Universal Time (UTC)
{
"errors": [
"accountInactive"
],
"error": "accountInactive",
"result": "error",
"serverTime": "2020-08-27T17:03:33.196Z"
}