Skip to content

Trading · Beta

Orderly
API integration

Ship Trading features without building the integration. Full Orderly API access via Proxy and 130+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Built for specific customer use cases. Issues are resolved quickly.

Talk to us
Orderly

Use Cases

Why integrate with Orderly

Common scenarios for SaaS companies building Orderly integrations for their customers.

01

Embed perpetual futures trading in a Web3 wallet

Wallets and portfolio dashboards can offer native perps trading without building matching engines or bootstrapping liquidity. Truto handles the Orderly connection so teams can ship in-app trading and monetize via custom fee markups.

02

Power algorithmic trading and AI agent platforms

SaaS platforms offering trading bots or LLM-driven agents can execute batch orders, TP/SL, and bracket strategies against Orderly's shared CLOB. Truto abstracts auth and key management so agents can trade safely at scale.

03

Run delta-neutral and basis-trading vaults

DeFi yield SaaS products can automate funding-rate harvesting by opening hedged positions per client sub-account. Truto lets teams read predicted funding rates and manage settlements without maintaining custom Orderly infrastructure.

04

Launch a white-label broker with revenue share

Any SaaS with a crypto-native user base can become an Orderly Builder, configure per-user maker/taker fees, and track broker tier volume. Truto makes the fee and campaign endpoints available through one consistent interface.

05

Manage segregated portfolios for institutional clients

Treasury and asset-management SaaS tools can provision sub-accounts per client, isolate margin, and systematically settle PnL. Truto handles the underlying Orderly calls so operations teams get clean, auditable workflows.

What You Can Build

Ship these features with Truto + Orderly

Concrete product features your team can ship faster by leveraging Truto’s Orderly integration instead of building from scratch.

01

Native perps order ticket

Ship a fully functional market/limit order ticket backed by create_a_orderly_order, bulk updates, and cancel-all-after safety timers.

02

TP/SL and bracket order automation

Let users attach take-profit and stop-loss legs to any position using create_a_orderly_algo_order and algo order bulk management.

03

TradingView-powered charting module

Render institutional-grade charts using the orderly_tradingview_* endpoints for OHLCV bars, symbol info, and config — no data transformation required.

04

Position and risk dashboard

Surface real-time positions, leverage settings, margin mode, and holdings via orderly_positions_list_lite, list_all_orderly_leverage, and orderly_holdings_get_current.

05

Builder fee and revenue console

Configure per-user maker/taker markups with orderly_fees_update_user_rate and track your broker tier via orderly_fees_get_builder_tier_info and orderly_builder_get_stats.

06

Sub-account treasury manager

Provision client sub-accounts, move funds via internal transfers, and automate PnL settlement using create_a_orderly_sub_account and orderly_sub_accounts_settle_pnl.

SuperAI

Orderly AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

create_a_orderly_order

Create a new order in Orderly. Returns: order_id, client_order_id, order_type, order_price, order_quantity, error_message. Required: symbol, order_type, side.

orderly_orders_cancel

Cancel an order in Orderly by client_order_id. Returns: status. Required: client_order_id.

list_all_orderly_orders

List orders in Orderly with optional filtering by symbol, side, order type, status, and time range. Returns: order_id, user_id, price, type, quantity, amount, total_executed_quantity, visible_quantity, symbol, side, status, total_fee, fee_asset, client_order_id, average_executed_price, created_time, updated_time, realized_pnl, executed_quantity, visible, executed, reduce_only, order_tag,…

orderly_orders_get_by_client_order_id

Get a single order in Orderly by client_order_id. Returns: success, data, timestamp. Required: client_order_id.

orderly_orders_cancel_all_after

Set a timer to cancel all open orders in Orderly after a specified timeout in milliseconds. Returns: expected_trigger_time. Required: trigger_after.

get_single_orderly_order_by_id

Get a single Orderly order by id. Returns: order_id, user_id, price, type, quantity, amount, total_executed_quantity, visible_quantity, symbol, side, status, total_fee, fee_asset, client_order_id, average_executed_price, created_time, updated_time, realized_pnl, executed_quantity, visible, executed, reduce_only, order_tag, margin_mode. Required: id.

delete_a_orderly_order_by_id

Cancel a pending Orderly order. Returns: status. Required: symbol, order_id.

orderly_orders_bulk_delete

Cancel all pending Orderly orders for the authenticated account, optionally filtered by symbol. Returns: status.

orderly_orders_bulk_update

Edit an existing Orderly order by submitting updated order parameters. Returns: status. Required: order_id, symbol, order_type, side.

update_a_orderly_margin_mode_by_id

Update the margin mode for a specific trading symbol in Orderly. Returns: success, timestamp. Required: symbol, default_margin_mode.

list_all_orderly_margin_modes

List margin modes for all trading symbols in Orderly. Returns: symbol, default_margin_mode. Each row represents one symbol's current margin mode setting.

update_a_orderly_position_margin_by_id

Add or reduce position margin for an isolated position in Orderly. Returns: success, timestamp. Required: symbol, amount, type.

create_a_orderly_internal_transfer

Create an internal transfer in Orderly by specifying a token and a list of receivers. Returns: internal_transfer_request_id. Required: token, receiver_list. Maximum 50 receivers per request; transferring to yourself will cause the request to fail.

orderly_internal_transfers_get_nonce

Get the transfer nonce for internal transfers in Orderly. Returns: transfer_nonce.

list_all_orderly_internal_transfers

List internal transfer history in Orderly with optional filters by status, time range, side, and account. Returns: internal_transfer_request_id, id, token, amount, from_account_id, to_account_id, status, created_time, updated_time. Required: side.

delete_a_orderly_orderly_key_by_id

Remove an Orderly key from the authenticated account in Orderly. Returns: success, timestamp. Required: orderly_key.

orderly_orderly_keys_get_current_key_info

Get current Orderly key info for the authenticated account, optionally filtered by key status. Returns: orderly_key, key_status, ip_restriction_list, ip_restriction_status, expiration, scope, tag.

orderly_orderly_keys_get_ip_restriction

Get the IP restriction configuration for a specific Orderly key in Orderly. Returns: account_id, orderly_key, ip_restriction_list, tag. Required: orderly_key.

orderly_orderly_keys_set_ip_restriction

Set the allowed IP restriction list for a specific Orderly key in Orderly. Returns: ip_restriction_list. Required: orderly_key, ip_restriction_list.

orderly_orderly_keys_reset_ip_restriction

Reset the IP restriction for a specific Orderly key in Orderly to either allow all IPs or block all IPs. Returns: success, timestamp. Required: orderly_key, reset_mode.

orderly_user_volume_get_daily

Get daily perpetual trading volume for the authenticated user in Orderly within a specified date range. Returns an array of entries each containing date and perp_volume. Required: start_date, end_date.

orderly_user_volume_get_statistics

Get aggregate perpetual trading volume statistics for the authenticated user in Orderly. Returns: perp_volume_ytd, perp_volume_ltd, perp_volume_today, perp_volume_last_1_day, perp_volume_last_7_days, perp_volume_last_30_days.

orderly_client_get_statistics

Get aggregate trading statistics for the authenticated account in Orderly. Returns: days_since_registration, fees_paid_last_30_days, perp_fees_paid_last_30_days, perp_trading_volume_last_24_hours, perp_trading_volume_last_30_days, perp_trading_volume_ytd, trading_volume_last_24_hours, trading_volume_last_30_days, trading_volume_ytd, perp_trading_volume_last_7_days, perp_trading_volume_ltd.

orderly_client_get_info

Get account configuration and fee information for the authenticated account in Orderly. Returns: account_id, email, account_mode, max_leverage, taker_fee_rate, maker_fee_rate, futures_taker_fee_rate, futures_maker_fee_rate, maintenance_cancel_orders, imr_factor, rwa_taker_fee_rate, rwa_maker_fee_rate, max_notional.

orderly_client_get_daily_statistics

Get daily trading statistics for the authenticated account in Orderly within a specified date range. Returns rows containing account_value, date, perp_volume, pnl, and snapshot_time. Required: start_date, end_date. When include_historical_data is true, the rate limit becomes 1 request per 60 seconds.

orderly_account_get_overview_info

Get account overview info in Orderly, including margin ratios and collateral values. Returns: current_margin_ratio_with_orders, free_collateral, initial_margin_ratio, initial_margin_ratio_with_orders, maintenance_margin_ratio, maintenance_margin_ratio_with_orders, margin_ratio, open_margin_ratio, total_collateral_value, account_value, total_pnl_24h.

orderly_account_check_exists

Check if an Orderly account exists by account_id. Returns: address, broker_id.

list_all_orderly_notifications

List all notifications in Orderly, optionally filtered by type. Returns: id, message_type, email, application_id, title, type, level, content_summary, content, content_raw, mark_read, operator, created_time, announcement_id.

orderly_notifications_get_unread

Get a summary of unread notifications in Orderly, returning the unread count and the ID of the most recent unread notification. Returns: count, last_id.

orderly_notifications_mark_read

Mark specific notifications as read or unread in Orderly. Returns: success, timestamp, count, last_id. Required: flag, ids.

orderly_notifications_mark_all_read

Mark all notifications as read or unread in Orderly. Returns: success, timestamp, count, last_id. Required: flag.

list_all_orderly_leverage

List all leverage settings for the authenticated Orderly account. Returns: symbol, margin_mode, leverage.

orderly_leverage_list_all

Retrieve every leverage setting configured for the authenticated Orderly account. Returns: symbol, margin_mode, leverage.

update_a_orderly_leverage_by_id

Update the leverage setting for a perpetual contract in Orderly. Returns: symbol, margin_mode, leverage. Required: leverage, symbol. Leverage must be an integer between 1 and 100; margin_mode defaults to CROSS.

orderly_leverage_get_configuration

Get the available leverage configuration from Orderly. Returns: available_futures_leverage.

orderly_leverage_get_max_setting

Get the maximum leverage setting from Orderly. Returns: max_futures_leverage.

get_single_orderly_leverage_by_id

Get the leverage setting for a specific trading symbol in Orderly. Returns: symbol, margin_mode, leverage. Required: symbol. The margin_mode parameter defaults to CROSS and accepts CROSS or ISOLATED.

orderly_builder_get_volume

Get builder perpetual volume stats in Orderly. Returns: perp_volume_ytd, perp_volume_ltd, perp_volume_today, perp_volume_last_1_day, perp_volume_last_7_days, perp_volume_last_30_days.

list_all_orderly_builder

List builders (brokers) in Orderly. Returns rows containing broker_id and broker_name. Optional: broker_id.

orderly_builder_get_stats

Get builder stats in Orderly. Returns rows containing connected_user counts. Optional: broker_id.

orderly_builder_get_supported_chains

Get supported blockchain chains per builder in Orderly. Returns rows with chain name, chain_id, currency_symbol, public_rpc_url, vault_address, and supported broker_ids. Optional: broker_id.

orderly_builder_get_market_volume

Get futures market volume by builder in Orderly. Returns rows with per-market data including symbol, index_price, mark_price, funding rates, open_interest, and 24h price/volume statistics. Optional: symbol, broker_id.

orderly_builder_get_tvl

Get TVL (Total Value Locked) stats by builder in Orderly. Returns: total_holding, total_unsettled_balance, last_update_time. The optional broker_id filters results to a single builder; when omitted, TVL is returned for all brokers.

orderly_system_get_maintenance_status

Get the current Orderly system maintenance status. Returns: status, msg, scheduled_maintenance.

orderly_vault_get_balance

Get Orderly vault balances, optionally filtered by chain and token. Returns a rows array where each entry includes chain_id, token, and balance. Both parameters are optional; omitting token returns all supported tokens.

orderly_insurance_fund_get_info

Get insurance fund info from Orderly. Returns: min_insurance_fund_initial_margin_ratio, min_insurance_fund_margin_ratio, margin_ratio, total_collateral_value, balance, free_collateral, total_account_value, total_pnl_24_h, rows.

orderly_insurance_fund_claim

Claim from the Orderly insurance fund for a specific liquidation. Returns: liquidation_id, timestamp, positions_by_perp. Required: claim_id, symbol, qty_request.

list_all_orderly_announcements

List announcements from Orderly. Returns: announcement_id, message, url.

orderly_ip_get_info

Get IP information from Orderly, including the detected city, IP address, region, and whether the IP has been checked. Returns: city, ip, checked, region.

orderly_faucet_get_usdc

Get testnet USDC from the Orderly faucet for a specified wallet address. Returns: success, timestamp. Required: user_address, broker_id. Omit chain_id for Solana deposits.

orderly_wallet_check_registered

Check if a wallet is registered in Orderly. Returns: user_id, account_id. Required: address, broker_id.

orderly_address_check_registered

Check if a wallet address is registered in Orderly and retrieve its associated broker IDs. Returns: broker_id. Required: address.

orderly_registration_get_nonce

Get a registration nonce from Orderly for use in account registration. Returns: registration_nonce. No parameters required.

orderly_registration_register_account

Register a new account on Orderly by submitting a wallet-signed message. Returns: account_id. Required: message, signature, userAddress.

orderly_orderly_key_add

Add an Orderly access key to the network by submitting an EIP-712 signed message. Returns: orderly_key, id. Required: message, signature, userAddress.

list_all_orderly_orderly_key

Get an Orderly access key by account ID and public key. Returns: orderly_key, scope, expiration, tag, id. Required: account_id, orderly_key.

create_a_orderly_batch_order

Create multiple orders in a single batch request in Orderly. Returns: status. Required: orders (each order requires symbol, order_type, side, client_order_id). reduce_only is not supported for batch order items.

orderly_batch_orders_bulk_delete

Cancel multiple open orders in a single batch request in Orderly. Returns: status. Required: order_ids (comma-separated, maximum of 10 order IDs per request).

create_a_orderly_algo_order

Create one or more algo orders in Orderly by submitting a JSON array supporting STOP, TP_SL, POSITIONAL_TP_SL, and BRACKET types with nested child orders for take-profit and stop-loss legs. Returns: order_id, client_order_id, algo_type, quantity.

list_all_orderly_algo_orders

List algo orders in Orderly with optional filters by symbol, status, side, algo_type, order type, and time range. Returns: algo_order_id, algo_status, algo_type, fee_asset, is_triggered, order_tag, parent_algo_order_id, quantity, root_algo_order_id, root_algo_order_status, side, symbol, total_executed_quantity, total_fee, trigger_price, trigger_price_type, type, created_time, updated_time,…

delete_a_orderly_algo_order_by_id

Cancel a single algo order in Orderly by symbol and order_id. Returns: status. Required: symbol, order_id.

orderly_algo_orders_bulk_delete

Cancel all pending algo orders in Orderly, optionally filtered by symbol and algo_type. Returns: status. Specifying STOP as algo_type cancels both TAKE_PROFIT and STOP_LOSS orders.

orderly_algo_orders_bulk_update

Edit an existing algo order in Orderly by updating price, quantity, trigger price, trigger price type, and nested child orders. Returns: status. Required: order_id.

list_all_orderly_trades

List trades in Orderly, optionally filtered by symbol and time range. Returns: id, symbol, fee, fee_asset, side, order_id, executed_price, executed_quantity, executed_timestamp, is_maker, realized_pnl, match_id, margin_token, margin_change_qty, margin_mode, order_enum_fee, order_enum_fee_rate. Max 500 per page.

get_single_orderly_trade_by_id

Get a single trade in Orderly by id. Returns: id, symbol, fee, fee_asset, side, order_id, executed_price, executed_quantity, executed_timestamp, is_maker, realized_pnl, match_id, margin_token, margin_change_qty, margin_mode, order_enum_fee, order_enum_fee_rate. Required: id.

orderly_trades_list_by_order

List all trades for a specific order in Orderly. Returns: id, symbol, fee, fee_asset, side, order_id, executed_price, executed_quantity, executed_timestamp, is_maker, realized_pnl, match_id, margin_token, margin_change_qty, margin_mode, order_enum_fee, order_enum_fee_rate. Required: order_id.

orderly_trades_list_by_algo_order

List all trades for a specific algo order in Orderly. Returns: id, symbol, fee, fee_asset, side, order_id, executed_price, executed_quantity, executed_timestamp, is_maker, realized_pnl, match_id, margin_token, margin_change_qty, margin_mode, order_enum_fee, order_enum_fee_rate. Required: order_id.

list_all_orderly_positions

List all Orderly positions for the authenticated account. Returns: IMR_withdraw_orders, MMR_with_orders, average_open_price, cost_position, est_liq_price, fee_24_h, imr, last_sum_unitary_funding, mark_price, mmr, pending_long_qty, pending_short_qty, pnl_24_h, position_qty, settle_price, symbol, seq, timestamp, updated_time, unsettled_pnl, leverage, margin_mode, margin, accrued_funding_fee.

get_single_orderly_position_by_id

Get a single Orderly position by its symbol id. Returns: IMR_withdraw_orders, MMR_with_orders, average_open_price, cost_position, est_liq_price, fee_24_h, imr, last_sum_unitary_funding, mark_price, mmr, pending_long_qty, pending_short_qty, pnl_24_h, position_qty, settle_price, symbol, seq, timestamp, updated_time, unsettled_pnl, leverage, margin_mode, margin, accrued_funding_fee. Required: id.

orderly_positions_list_lite

List all Orderly positions with a reduced field set for the authenticated account. Returns: IMR_withdraw_orders, MMR_with_orders, average_open_price, cost_position, est_liq_price, fee_24_h, imr, last_sum_unitary_funding, mark_price, mmr, pending_long_qty, pending_short_qty, pnl_24_h, position_qty, settle_price, symbol, margin_mode, margin, timestamp, updated_time, unsettled_pnl, leverage.

orderly_positions_list_history

List position history in Orderly, including closed and liquidated positions. Returns: position_id, status, type, symbol, avg_open_price, avg_close_price, max_position_qty, closed_position_qty, side, trading_fee, accumulated_funding_fee, insurance_fund_fee, liquidator_fee, liquidation_id, realized_pnl, open_timestamp, close_timestamp, last_update_timestamp, leverage, margin_mode.

orderly_positions_list_aggregate

List aggregate positions across all accounts in Orderly. Returns: account_id, IMR_withdraw_orders, MMR_with_orders, average_open_price, cost_position, est_liq_price, fee_24_h, imr, last_sum_unitary_funding, mark_price, mmr, pending_long_qty, pending_short_qty, pnl_24_h, position_qty, settle_price, symbol, seq, timestamp, updated_time, unsettled_pnl, leverage.

orderly_holdings_get_current

Get current token holdings for the authenticated account in Orderly. Returns a holding array with token, holding, frozen, pending_short, isolated_margin, isolated_order_frozen, and updated_time per token. The optional all parameter includes tokens with empty balances.

orderly_holdings_get_aggregate

Get aggregate holdings across all accounts in Orderly. Returns an array of holding records including account_id, updated_time, token, holding, frozen, pending_short, isolated_margin, and isolated_order_frozen.

orderly_funding_fee_list_history

List funding fee history in Orderly. Returns: symbol, funding_rate, mark_price, funding_fee, payment_type, status, created_time, updated_time, margin_mode. Filter optionally by symbol and a 13-digit millisecond timestamp time range (start_t / end_t).

orderly_pnl_settlement_list_history

List PnL settlement history records for the authenticated Orderly account, optionally filtered by time range. Returns: id, old_balance, new_balance, settled_amount, requested_time, settled_time, symbols.

orderly_pnl_settlement_request

Request a PnL settlement in Orderly by submitting an EIP-712 signed message. Returns: settle_pnl_id. Required: signature, userAddress, verifyingContract, message.

orderly_pnl_settlement_get_nonce

Get the current settle PnL nonce for the authenticated Orderly account. Returns: settle_nonce.

create_a_orderly_withdrawal

Create a withdraw request in Orderly by submitting an EIP-712 signed message. Returns: withdraw_id. Required: signature, userAddress, verifyingContract, message.

orderly_withdrawals_get_nonce

Get the current withdrawal nonce for the authenticated Orderly account. Returns: withdraw_nonce.

create_a_orderly_sub_account

Create a new sub account in Orderly. Returns: sub_account_id, description.

list_all_orderly_sub_accounts

List all sub accounts for the authenticated main account in Orderly. Returns: sub_account_id, description.

update_a_orderly_sub_account_by_id

Update a sub account's description in Orderly. Returns: success, timestamp. Required: sub_account_id.

orderly_sub_accounts_settle_pnl

Settle the unrealized PnL for a sub account in Orderly. Returns: settle_pnl_id. Required: settle_nonce.

orderly_orderbook_get_snapshot

Get the current orderbook snapshot for a trading symbol in Orderly. Returns: symbol, mid_price, spread, asks, bids, ts. Required: symbol.

orderly_symbols_list_available

List all available trading symbols in Orderly with their order rules and market configuration. Returns: symbol, quote_min, quote_max, quote_tick, base_min, base_max, base_tick, min_notional, price_range, price_scope, std_liquidation_fee, liquidator_fee, claim_insurance_fund_discount, funding_period, cap_funding, floor_funding, interest_rate, created_time, updated_time, base_mmr, base_imr, cap_ir,…

orderly_symbols_get_order_rules

Get order rules for a specific trading symbol in Orderly. Returns the symbol's order constraints including symbol, quote_min, quote_max, base_min, base_max, min_notional, price_range, funding_period, base_mmr, base_imr, and liquidation parameters. Required: symbol.

orderly_markets_list_info

List futures market info for all symbols on Orderly. Returns: symbol, index_price, mark_price, sum_unitary_funding, est_funding_rate, last_funding_rate, next_funding_time, open_interest, 24h_open, 24h_close, 24h_high, 24h_low, 24h_amount, 24h_volume.

orderly_markets_get_info

Get futures market info for a single symbol on Orderly. Returns rows with symbol, index_price, mark_price, est_funding_rate, last_funding_rate, next_funding_time, open_interest, sum_unitary_funding, and 24h open/close/high/low/amount/volume statistics. Required: symbol.

orderly_funding_rate_list_all_markets

List funding rate history for all markets in Orderly. Returns: symbol, data_start_time, funding.

orderly_funding_rate_get_history

Get funding rate history for a single market in Orderly, optionally filtered by time range. Returns: symbol, funding_rate, funding_rate_timestamp, next_funding_time. Required: symbol.

orderly_funding_rate_get_predicted

Get the predicted funding rate for a single market in Orderly. Returns: symbol, est_funding_rate, est_funding_rate_timestamp, last_funding_rate, last_funding_rate_timestamp, next_funding_time, sum_unitary_funding. Required: symbol.

orderly_funding_rate_list_predicted_all_markets

List predicted funding rates for all markets in Orderly. Returns: symbol, est_funding_rate, est_funding_rate_timestamp, last_funding_rate, last_funding_rate_timestamp, next_funding_time, sum_unitary_funding.

orderly_prices_list_all_symbols

List price change information for all trading symbols on Orderly. Returns: symbol, last_price, 5m, 30m, 1h, 4h, 24h, 3d, 7d, 30d.

orderly_prices_list_historical

List historical price chart data for all trading symbols on Orderly. Returns: symbol, price_list. Optionally filter by time_interval.

orderly_kline_get_history

Get Orderly kline history in TradingView columnar format. Returns: s, o, c, h, l, v, a, t. Required: symbol, resolution.

list_all_orderly_kline

List Orderly kline (candlestick) data as row objects. Returns: open, close, low, high, volume, amount, symbol, type, start_timestamp, end_timestamp. Required: symbol, type.

list_all_orderly_market_trades

List recent market trades for a given trading symbol in Orderly. Returns: symbol, side, executed_price, executed_quantity, executed_timestamp. Required: symbol.

orderly_open_interests_list_all_symbols

List open interests for all symbols in Orderly. Returns: symbol, long_oi, short_oi, order_id, client_order_id, order_type, order_price, order_quantity, error_message. No required parameters.

orderly_collateral_get_supported_info

List the tokens that can be used as collateral within Orderly, including each token's collateral weighting, withdrawal limits and per-chain deposit details. Returns: rows. Optional: chain_id to filter the results to a single chain.

orderly_liquidated_positions_list_info

List liquidated positions in Orderly with optional filtering by trading symbol and time range. Returns: timestamp, liquidation_id, transfer_amount_to_insurance_fund, positions_by_perp, type.

orderly_liquidated_positions_list_under_liquidation

List positions currently under liquidation in Orderly with optional time range filtering. Returns: timestamp, liquidation_id, transfer_amount_to_insurance_fund, positions_by_perp, type.

orderly_liquidated_positions_claim

Claim a liquidated position in Orderly by specifying the liquidation ID, quantity ratio, and limit price. Returns: timestamp, liquidation_id, transfer_amount_to_insurance_fund, positions_by_perp, type. Required: liquidation_id, ratio_qty_request, limit_price.

orderly_staking_get_overview

Get the staking overview in Orderly, including the total staked amount and per-date reward records. Returns: total_stake, rows.

orderly_valor_get_pool_info

Get Orderly valor staking pool information. Returns: valor_price_usdc, treasury_pool_value, next_settlement_date, revenue_rate, est_treasury_inflow, total_redeemed_amount.

orderly_valor_get_batch_info

Get Orderly valor staking batch information. Returns: rows, valor_price_usdc, treasury_pool_value, next_settlement_date, revenue_rate, est_treasury_inflow, total_redeemed_amount.

orderly_index_price_get_source

Get index price source data from Orderly, listing the exchanges used to calculate index prices for each trading pair. Returns: rows.

orderly_tradingview_get_history_bars

Get TradingView OHLCV history bars for a trading symbol in Orderly. Returns: s, t, o, h, l, c, v. Required: symbol, resolution, from, to.

orderly_tradingview_get_symbol_info

Get TradingView UDF symbol info for a symbol group in Orderly. Returns: s, symbol, description, currency, base-currency, exchange-listed, exchange-traded, minmovement, minmovement2, fractional, pricescale, root, root-description, has-intraday, has-no-volume, type, is-cfd, ticker, timezone, session-regular, session-extended, session-premarket, session-postmarket, supported-resolutions, has-daily,…

orderly_tradingview_get_config_info

Get TradingView localized configuration info from Orderly for charting integration. Returns: accountSummaryRow, accountManager, durations, orderCustomFields, orderHistoryCustomFields, positionCustomFields, pullingInterval. Required: locale.

orderly_assets_list_history

List asset transfer history (deposits and withdrawals) in Orderly. Returns: id, tx_id, side, token, amount, fee, trans_status, created_time, updated_time, chain_id. Filter by token, transfer direction, status, and time range.

orderly_assets_list_conversion_history

List asset conversion history in Orderly. Returns: convert_id, account_id, user_address, converted_asset, received_asset, received_qty, type, status, details, created_time, updated_time. Required: start_t, end_t. Query range cannot exceed 180 days; provide either user_address or user_account, not both.

orderly_deposits_get_receiver_address

Get the deposit receiver address for a specific chain and token in Orderly. Returns: receiver_address, token_address, minimum_deposit. Required: chain_id.

orderly_deposits_list_receiver_events

List deposit receiver events in Orderly. Returns: chain_id, tx_id, token, amount, created_time, updated_time.

orderly_fees_get_user_rates

List user fee rates in Orderly, optionally filtered by account ID or wallet address. Returns: account_id, address, is_default_fee_rate, maker_fee_rate, taker_fee_rate, rwa_taker_fee_rate, rwa_maker_fee_rate.

orderly_fees_update_user_rate

Update maker and taker fee rates for specified user accounts in Orderly. Returns: success, timestamp. Required: maker_fee_rate, taker_fee_rate, account_ids. Fee rates must be set in decimal-rate increments of 0.00001 (0.001% or 0.1 bps).

orderly_fees_reset_user_rate

Reset fee rates to the default for specified user accounts in Orderly. Returns: success, timestamp. Required: account_ids.

orderly_fees_get_builder_tier_info

Get builder (broker) fee tier information in Orderly, including staked balance, 30-day volume, tier type, and base fee rates. Returns: broker_id, total_staked_balance, volume_last_30_days, type, base_maker_fee_rate, base_taker_fee_rate, base_rwa_maker_fee_rate, base_rwa_taker_fee_rate, updated_time.

orderly_fees_get_default_builder_fee

Get the default builder fee rates in Orderly. Returns: maker_fee_rate, taker_fee_rate, rwa_taker_fee_rate, rwa_maker_fee_rate.

orderly_fees_update_default_builder_fee

Update the default builder fee rates in Orderly, including maker, taker, and RWA fee rates. Returns: success, timestamp, maker_fee_rate, taker_fee_rate, rwa_taker_fee_rate, rwa_maker_fee_rate. Required: maker_fee_rate, taker_fee_rate. Fee rates must be set in decimal-rate increments of 0.00001 (0.001% or 0.1 bps).

orderly_valor_2_get_pool_info

Get valor2 staking pool info in Orderly. Returns: revenue_rate, valor_price_esorder, treasury_pool_value, est_treasury_inflow, order_price_usdc, total_redeemed_amount, current_batch_id, next_settlement_date.

orderly_valor_2_get_batch_info

Get valor2 staking batch info in Orderly. Returns the batch info object containing rows with batch_id, batch_start_time, and batch_end_time for each settlement batch.

orderly_valor_2_get_revenue_buyback

Get valor2 revenue buyback records in Orderly. Returns an array of buyback entries ordered by batch_id, each with batch_id, usdc_revenue, and esorder_amount. Amounts are displayed after the batch is claimable.

list_all_orderly_campaigns

List Orderly campaigns with optional time-range, alive-status, and address filters. Returns: id, name, start_time, end_time, signup_start_time, signup_end_time, register_time.

orderly_campaigns_get_statistics

Get aggregate trading statistics for a specific Orderly campaign, optionally filtered by broker and symbol. Returns: volume, user_count, sign_up_count, updated_time. Required: campaign_id.

orderly_campaigns_get_ranking

Get the participant ranking leaderboard for an Orderly campaign, sortable by volume or PnL. Returns rows containing broker_id, account_id, address, volume, pnl, total_deposit_amount, total_withdrawal_amount, start_account_value, and end_account_value, along with pagination meta. Required: campaign_id.

orderly_campaigns_get_user_info

Get a user's performance metrics within an Orderly campaign including volume, PnL, staking, and referral stats. Returns: volume, filled_order_count, updated_time, pnl, total_deposit_amount, total_withdrawal_amount, start_account_value, end_account_value, new_invited_referee, new_traded_referee, total_staked_order, total_staked_esorder. Required: campaign_id.

orderly_campaigns_get_detail

Get detailed Orderly campaign info with a per-broker, per-symbol breakdown of trading volume and user counts. Returns rows containing broker_id, symbol, volume, and user_count, along with pagination meta. Required: campaign_id.

orderly_referral_check_code

Check the referral code associated with an account in Orderly. Returns the referral_code string for the given account. Required: account_id.

orderly_referral_verify_code

Verify whether a referral code exists in Orderly. Returns a boolean exist field indicating if the code is valid. Required: referral_code.

orderly_referral_check_multilevel_code

Check the multilevel referral code associated with an account in Orderly. Returns the referral_code string for the given account. Required: account_id.

orderly_referral_verify_multilevel_code

Verify whether a multilevel referral code exists in Orderly. Returns a boolean exist field indicating if the code is valid. Required: referral_code.

orderly_delegate_signer_register

Register a delegate signer in Orderly by submitting a wallet-signed message. Returns: user_id, account_id, valid_signer. Required: message, signature, userAddress.

orderly_delegate_signer_add_orderly_key

Add a delegate signer Orderly key in Orderly by submitting a wallet-signed message. Returns: orderly_key, id. Required: message, signature, userAddress.

Why Truto

Why use Truto’s MCP server for Orderly

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 750+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Go live with Orderly in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Orderly account

Use Truto’s frontend SDK to connect your customer’s Orderly account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Orderly

Truto’s Proxy API is a 1-to-1 mapping of the Orderly API. You call us, we call Orderly, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Orderly’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Orderly on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How does authentication work for Orderly through Truto?

Orderly uses non-custodial, signature-based auth. Truto supports the EIP-712 flows for registering accounts (orderly_registration_register_account), adding Orderly keys (orderly_orderly_key_add), and registering delegate signers (orderly_delegate_signer_register) so end users retain custody while your app trades on their behalf.

Can I restrict API keys to specific IPs for AI agents or backend workers?

Yes. Truto exposes orderly_orderly_keys_set_ip_restriction, orderly_orderly_keys_get_ip_restriction, and orderly_orderly_keys_reset_ip_restriction so you can lock keys down to trusted infrastructure and rotate restrictions programmatically.

Which order types are supported?

You can place standard orders (create_a_orderly_order), batch orders (create_a_orderly_batch_order), and algorithmic orders including TP/SL and bracket variants (create_a_orderly_algo_order). Bulk update and bulk delete are supported for both regular and algo orders.

How do I monetize trades as a Builder?

Use orderly_fees_update_user_rate to set custom maker/taker markups per user, orderly_fees_update_default_builder_fee for defaults, and orderly_fees_get_builder_tier_info plus orderly_builder_get_stats / orderly_builder_get_volume to track your revenue tier and volumes.

Can I manage multiple end-user portfolios in one integration?

Yes. Use create_a_orderly_sub_account and list_all_orderly_sub_accounts to segregate margin per client, update_a_orderly_sub_account_by_id for configuration, and orderly_sub_accounts_settle_pnl to systematically realize PnL.

What market data can I pull for charts and analytics?

Truto exposes orderbook snapshots, kline history, historical and live prices, funding rate history and predictions, open interest, and TradingView-formatted bars — enough to power full trading UIs and yield calculators without a separate data provider.

Orderly

Get Orderly integrated into your app

Our team understands what it takes to make a Orderly integration successful. A short, crisp 30 minute call with folks who understand the problem.