API

A developer's starting point for trading on Vanta programmatically.

Vanta's perpetual trading runs on Orderly's omnichain infrastructure. That means anything you build for API trading on Vanta uses Orderly's official SDKs, connectors, and API — the same battle-tested toolkit, pointed at your Vanta account. This page gives you the essentials and links to the full documentation.

Before you start

1. Set up API trading in your account and create an Orderly Key (your signing key).
2. Note your account ID and keep your key and secret safe — they sign every private request.
3. Pick your environment: Mainnet for live trading, Testnet for testing. All private requests are signed using the ed25519 standard with your Orderly Key.

SDKs & connectors

Choose the library that matches your stack:

• Python — orderly-evm-connector A lightweight connector for REST and WebSocket, with built-in request signing.

pip install orderly-evm-connector

from orderly_evm_connector.rest import Rest as Client
client = Client(
    orderly_key=orderly_key,
    orderly_secret=orderly_secret,
    orderly_account_id=orderly_account_id,
    orderly_testnet=True,
)

• TypeScript / JavaScript — @orderly.network/hooks React hooks for REST and WebSocket access (useQuery, usePrivateQuery, useMutation, useWS). For lower-level control, @orderly.network/net exposes the underlying WebSocket client.

API endpoints

REST

Environment	Base URL
Mainnet	https://api.orderly.org/
Testnet	https://testnet-api.orderly.org

WebSocket

Stream	Mainnet URL
Market data (public)	wss://ws-evm.orderly.org/ws/stream/{account_id}
User data (private)	wss://ws-private-evm.orderly.org/v2/ws/private/stream/{account_id}

Symbols use the format PERP_<BASE>_USDC, for example PERP_ETH_USDC. Rate limits are counted per Orderly Key; exceeding them returns HTTP 429.

Full documentation

• API overview (REST): orderly.network/docs/build-on-omnichain/introduction
• WebSocket API: orderly.network/docs/build-on-omnichain/websocket-api/introduction
• Hooks SDK (low-level API): orderly.network/docs/sdks/hooks/api/api
• Python connector: github.com/OrderlyNetwork/orderly-evm-connector-python

info

Start on Testnet to validate your integration before going live. Generate a separate Orderly Key for each application so you can revoke access independently.

warning

Your Orderly Key and secret can place and cancel orders on your account. Store them securely, never commit them to source control, and delete keys you no longer use.