Method Name
public/get_ticker
public/get_tickerGet ticker information (best bid / ask, instrument contraints, fees info, etc.) for a single instrument
Parameters
| instrument_name
string
required
Instrument name |
Response
| id
string or integer
required
|
| result
object
required
|
| result.amount_step
string
required
Minimum valid increment of order amount |
| result.base_asset_address
string
required
Blockchain address of the base asset |
| result.base_asset_sub_id
string
required
Sub ID of the specific base asset as defined in Asset.sol |
| result.base_currency
string
required
Underlying currency of base asset ( ETH, BTC, etc) |
| result.base_fee
string
required
$ base fee added to every taker order |
| result.best_ask_amount
string
required
Amount of contracts / tokens available at best ask price |
| result.best_ask_price
string
required
Best ask price |
| result.best_bid_amount
string
required
Amount of contracts / tokens available at best bid price |
| result.best_bid_price
string
required
Best bid price |
| result.erc20_details
object or null
required
Details of the erc20 asset (if applicable) |
| result.erc20_details.decimals
integer
required
Number of decimals of the underlying on-chain ERC20 token |
| result.erc20_details.borrow_index
string
Latest borrow index as per CashAsset.sol implementation |
| result.erc20_details.supply_index
string
Latest supply index as per CashAsset.sol implementation |
| result.erc20_details.underlying_erc20_address
string
Address of underlying on-chain ERC20 (not V2 asset) |
| result.fifo_min_allocation
string
required
Minimum number of contracts that get filled using FIFO. Actual number of contracts that gets filled by FIFO will be the max between this value and (1 - pro_rata_fraction) x order_amount, plus any size leftovers due to rounding. |
| result.five_percent_ask_depth
string
required
Total amount of contracts / tokens available at 5 percent above best ask price |
| result.five_percent_bid_depth
string
required
Total amount of contracts / tokens available at 5 percent below best bid price |
| result.index_price
string
required
Index price |
| result.instrument_name
string
required
Instrument name |
result.instrument_type
string
required
erc20, option, or perpenum erc20 option perp |
| result.is_active
boolean
required
If True: instrument is tradeable within activation and deactivation timestamps |
| result.maker_fee_rate
string
required
Percent of spot price fee rate for makers |
| result.mark_price
string
required
Mark price |
| result.max_price
string
required
Maximum price at which an agressive buyer can be matched. Any portion of a market order that would execute above this price will be cancelled. A limit buy order with limit price above this value is treated as post only (i.e. it will be rejected if it would cross any existing resting order). |
| result.maximum_amount
string
required
Maximum valid amount of contracts / tokens per trade |
| result.min_price
string
required
Minimum price at which an agressive seller can be matched. Any portion of a market order that would execute below this price will be cancelled. A limit sell order with limit price below this value is treated as post only (i.e. it will be rejected if it would cross any existing resting order). |
| result.minimum_amount
string
required
Minimum valid amount of contracts / tokens per trade |
| result.option_details
object or null
required
Details of the option asset (if applicable) |
| result.option_details.expiry
integer
required
Unix timestamp of expiry date (in seconds) |
| result.option_details.index
string
required
Underlying settlement price index |
| result.option_details.option_type
string
required
enum C P |
| result.option_details.strike
string
required
|
| result.option_details.settlement_price
string or null
Settlement price of the option |
| result.option_pricing
object or null
required
Greeks, forward price, iv and mark price of the instrument (options only) |
| result.option_pricing.ask_iv
string
required
Implied volatility of the current best ask |
| result.option_pricing.bid_iv
string
required
Implied volatility of the current best bid |
| result.option_pricing.delta
string
required
Delta of the option |
| result.option_pricing.forward_price
string
required
Forward price used to calculate option premium |
| result.option_pricing.gamma
string
required
Gamma of the option |
| result.option_pricing.iv
string
required
Implied volatility of the option |
| result.option_pricing.mark_price
string
required
Mark price of the option |
| result.option_pricing.rho
string
required
Rho of the option |
| result.option_pricing.theta
string
required
Theta of the option |
| result.option_pricing.vega
string
required
Vega of the option |
| result.perp_details
object or null
required
Details of the perp asset (if applicable) |
| result.perp_details.aggregate_funding
string
required
Latest aggregated funding as per PerpAsset.sol |
| result.perp_details.funding_rate
string
required
Current hourly funding rate as per PerpAsset.sol |
| result.perp_details.index
string
required
Underlying spot price index for funding rate |
| result.perp_details.max_rate_per_hour
string
required
Max rate per hour as per PerpAsset.sol |
| result.perp_details.min_rate_per_hour
string
required
Min rate per hour as per PerpAsset.sol |
| result.perp_details.static_interest_rate
string
required
Static interest rate as per PerpAsset.sol |
| result.pro_rata_amount_step
string
required
Pro-rata fill share of every order is rounded down to be a multiple of this number. Leftovers of the order due to rounding are filled FIFO. |
| result.pro_rata_fraction
string
required
Fraction of order that gets filled using pro-rata matching. If zero, the matching is full FIFO. |
| result.quote_currency
string
required
Quote currency ( USD for perps, USDC for options) |
| result.scheduled_activation
integer
required
Timestamp at which became or will become active (if applicable) |
| result.scheduled_deactivation
integer
required
Scheduled deactivation time for instrument (if applicable) |
| result.taker_fee_rate
string
required
Percent of spot price fee rate for takers |
| result.tick_size
string
required
Tick size of the instrument, i.e. minimum price increment |
| result.timestamp
integer
required
Timestamp of the ticker feed snapshot |
| result.stats
object
required
Aggregate trading stats for the last 24 hours |
| result.stats.contract_volume
string
required
Number of contracts traded during last 24 hours |
| result.stats.high
string
required
Highest trade price during last 24h |
| result.stats.low
string
required
Lowest trade price during last 24h |
| result.stats.num_trades
string
required
Number of trades during last 24h |
| result.stats.open_interest
string
required
Current total open interest |
| result.stats.percent_change
string
required
24-hour price change expressed as a percentage. Options: percent change in vol; Perps: percent change in mark price |
| result.stats.usd_change
string
required
24-hour price change in USD. |
| result.mark_price_fee_rate_cap
string or null
Percent of option price fee cap, e.g. 12.5%, null if not applicable |
Example
{request_example_shell}
{request_example_javascript}
{request_example_python}
The above command returns JSON structured like this:
{response_example_json}