TRADEHUBTESTNET

All tools

get_perp_contract_rules

Perpetual contract rules · read-only, idempotent, no account needed · scopes: read

Rules and current funding for one perpetual futures contract on one exchange: mark price, size step, minimum size, price tick, maximum leverage, funding rate per interval and annualised. Use when a limit price or leverage must fit the venue; not needed for market orders (sizing and preview round for you). Not for comparing exchanges (use compare_perp_quotes_across_venues or compare_funding_rates_across_venues). Inputs: symbol (base coin, e.g. BTC), venue (without an account: hyperliquid only). Prices in USD per coin, sizes in the base coin, rates as fractions. Next: size_position_by_risk.

Call it

MCP tools/call

{"name": "get_perp_contract_rules", "arguments": {"symbol": "BTC"}}

REST

GET /v1/markets/{symbol}

Inputs

NameMeaning (* required)
symbol *Base coin, e.g. BTC
venueVenue: sandbox, hyperliquid, okx, bybit or binance. Omitted: the agent's only venue, else hyperliquid, else your only connected venue, else sandbox

Returns

FieldMeaning and unit
venueVenue name
symbolBase coin
mark_priceMark price, USD per coin
size_stepSmallest size increment, in the base coin (e.g. BTC), not USD
min_sizeSmallest order, in the base coin (e.g. BTC), not USD
price_tickSmallest price increment, USD per coin
max_leverageHighest leverage the venue allows for this contract
funding_rateFunding rate per interval, as a fraction (0.0001 = 0.01%); positive: longs pay
funding_interval_hoursHours between funding payments
funding_annualizedfunding_rate scaled to a year, as a fraction

Rejections: error codes, each with what to do.

TradeHub never asks for withdrawal permissions.