---
title: Orderly API Integration on Truto
slug: orderly
category: Trading
canonical: "https://truto.one/integrations/detail/orderly/"
---

# Orderly API Integration on Truto



**Category:** Trading  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 134 tools for Orderly that AI agents can call directly.

- **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.

## How it works

1. **Link your customer's Orderly account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Orderly.** The Proxy API is a 1-to-1 mapping of the Orderly API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **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.
- **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.
- **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.
- **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.
- **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

- **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.
- **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.
- **TradingView-powered charting module** — Render institutional-grade charts using the orderly_tradingview_* endpoints for OHLCV bars, symbol info, and config — no data transformation required.
- **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.
- **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.
- **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.

## FAQs

### 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.

## Related reading

- [Connect Orderly to Claude: Track market trends and account performance](https://truto.one/blog/connect-orderly-to-claude-track-market-trends-and-account-performance/) — Learn how to connect Orderly to Claude using a managed MCP server. Execute trades, monitor margin ratios, and analyze market trends using natural language.
- [Connect Orderly to ChatGPT: Execute trades and manage margin settings](https://truto.one/blog/connect-orderly-to-chatgpt-execute-trades-and-manage-margin-settings/) — Learn how to connect Orderly to ChatGPT using a managed MCP server. Execute crypto trades, manage margin settings, and automate portfolio workflows using natural language.
- [Connect Orderly to AI Agents: Automate Trading and Asset Transfers](https://truto.one/blog/connect-orderly-to-ai-agents-automate-trading-and-asset-transfers/) — Learn how to connect Orderly to ai agents using Truto. Step-by-step guide to tool calling, API quirks, and autonomous workflows.