Method Name

`public/get_instrument`

Get single instrument by asset name

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. 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. instrument_name string required Instrument name
result. instrument_type string required `erc20`, `option`, or `perp` enum `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. maximum_amount string required Maximum valid amount of contracts / tokens per trade
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. 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. 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}