Tetrac
Back to App

Tetrac Documentation

Comprehensive guide to understanding, using, and contributing to Tetrac

Meet TTC

TTC (Tetrac) builds trading tools based on a decade of trading experience. We're here to make innovative trading tools to increase your productivity and make you more money in your trading journey.

What is Tetrac

Tetrac is a comprehensive trading terminal designed for cryptocurrency traders. It provides real-time market data, advanced charting capabilities, and streamlined trading interfaces to help traders make informed decisions. Built with modern web technologies, Tetrac offers a responsive and feature-rich experience for both novice and professional traders. TTC.BOX is also the first to integrate a multi exchange Crypto Bridge to MetaTrader5 for charting, trading, and a unified robot framework.

Why We Built This

We built Tetrac to address the lack of intuitive, feature-rich trading platforms specifically designed for cryptocurrency markets. Traditional trading platforms often lack the specialized tools needed for crypto trading, while existing crypto platforms can be overwhelming or lack professional-grade features.

Tetrac bridges this gap by combining the best aspects of professional trading platforms with the accessibility and flexibility needed for cryptocurrency markets. We needed to take the headache out of trading across several exchanges. Therefore, we streamlined the process to manage accounts easily across the ever expanding crypto derivatives markets.

Who This Is For

  • Professional cryptocurrency traders
  • Day traders looking for real-time data visualization
  • Investors who want to monitor multiple assets
  • Developers building trading applications who need a reference implementation

Features

Real-time tracking for all perpetual contracts
Simple and Pro Trading interfaces
Portfolio tracking and performance analytics
Customizable dashboards
Dark/light theme support
Responsive design for desktop, tablet, and mobile use
WebSocket integration for live data feeds
Multi-exchange Futures Trading (CEX | DEX)

API Documentation

Tetrac provides a comprehensive API for accessing market data, executing trades, and managing user accounts.

For detailed API documentation, please refer to the API Documentation page.

MCP Integration

The TTC MCP server exposes every trading, market-data, and wallet tool in your MCP-capable host (Claude Desktop, Cursor, Windsurf, Claude Code, etc.). Once connected, you can ask your agent to place orders, fetch tickers, or read balances just by talking to it — no manual curl, no per-endpoint auth wiring.

Endpoint: https://ttc.box/api/v1/mcp

Step 1 — Copy your MCP config

Log in and go to the trading dashboard. Next to the Skills button at the top, click MCP Config. This copies a ready-to-paste JSON block containing your ttc-auth-token and ttc-public-key session headers.

Heads up: the session token expires every 24 hours. When tool calls start failing with 401, login again, re-copy and paste again.

Step 2 — Paste into your MCP client config

Open your MCP host's config file and paste the block into the mcpServers object. For Claude Code, the file is .mcp.json in the project root. For Claude Desktop, it's ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "ttc": {
      "type": "http",
      "url": "https://ttc.box/api/v1/mcp",
      "headers": {
        "ttc-auth-token": "<paste>",
        "ttc-public-key": "<paste>"
      }
    }
  }
}

Step 3 — Restart your MCP client

MCP hosts read the config at startup, so quit and reopen the app (or run /mcp in Claude Code to reconnect). The TTC server should appear in your tools list with tickers, orders, positions, and wallet actions exposed.

Try asking: “show me Binance BTC ticker via TTC” — the agent will call get_tickers with your session headers and return live data, no x402 payment needed.

Troubleshooting

  • Payment Required / 402 on every tool: your headers aren't being sent. Re-copy from the dashboard and confirm the headers block is inside your server entry (not at the root).
  • 401 Unauthorized after ~24h: session token expired. Re-copy from the dashboard and paste over the old headers.
  • Tool not showing up:your MCP client may have cached the old server. Fully restart it; don't just reload the window.

MT5 Documentation

Tetrac provides enhanced MetaTrader 5 integration with additional features and capabilities.

For detailed MT5 documentation, please refer to the MT5 Documentation page.

Debug Tooling

For detailed error codes, please refer to the Debugging utility. page.

Trading Functionality

Advanced Order Management

Our trading panel provides comprehensive order management capabilities:

  • Multiple order types: Market, Limit, Stop, and Reduce orders
  • One-Click limit orders at best Bid | Ask
  • Toast notifications
  • Batch operations: Cancel all orders or close all positions

Position Management

Comprehensive position tracking and management tools:

  • Real-time position monitoring with PnL calculations
  • One-click position closing
  • Position scaling with breakeven and lock-in features
  • Margin mode selection (Isolated/Cross)
  • Hedge mode support for two-way positions

Risk Management Tools

Advanced risk management features to protect your capital:

  • Dynamic leverage adjustment (1.5x to 50x)
  • Stop-loss and take-profit order placement
  • Position liquidation price monitoring
  • Auto-detection of hedge/one-way mode based on existing positions
  • "Save Me" feature to place protective orders near liquidation price

Exchange Integration

Seamless integration with multiple cryptocurrency exchanges:

  • Secure API key management with encrypted storage
  • Supports most Perp CEX and DEX. See full list below.
  • Automatic market data fetching and symbol search
  • Real-time balance and position synchronization

Signal Copier

Automatically mirror DAO trading signals to your Orderly Network account. The signal copier compares DAO positions against your own portfolio and executes trades to stay in sync — with built-in risk controls and equity thresholds.

  • Automatic position synchronization with configurable polling intervals
  • Equity threshold protection — copier stops if account balance drops below configured limits
  • Symbol blacklist to exclude specific markets from being copied
  • Activity log with full history of executed signals and sync events
  • Responsive design with dedicated mobile bottom-sheet interface and desktop dashboard layout
  • Real-time account overview with balance, open positions, and pending orders

Access at /trading/copier. Requires Orderly Network credentials configured via the desktop trading page.

Trading Analytics

Overview

Tetrac provides comprehensive trading analytics tools to help you analyze your trading performance across multiple exchanges. Our analytics dashboard includes position history tracking, PnL analysis, win/loss statistics, and advanced charting capabilities.

Exporting Trade History

Export your complete position history to CSV or PDF format for offline analysis, backup, or sharing.

How to Export

  1. Navigate to the Trading Analytics page
  2. Select your exchange from the dropdown
  3. View your position history and analytics
  4. Click the CSV or PDF export buttons in the Position History section
  5. The file will download automatically

CSV Export Format

Filename: EXCH_WALL_YYYY-MM-DD.csv

Where:

  • EXCH - Exchange name (first 4 letters, uppercase)
  • WALL - Wallet identifier (4 characters, uppercase)
  • YYYY-MM-DD - Export date

CSV Columns:

Symbol,Side,Qty,Open Price,Close Price,Duration,Closed At,Realized PnL

PDF Export Features

  • Professional landscape layout
  • Includes all position history data
  • Color-coded PnL (green for profit, red for loss)
  • Side badges (green for LONG, red for SHORT)
  • Export summary with total positions and total PnL

Importing Trade History

Import previously exported CSV files to analyze your trading history without connecting to exchanges. Perfect for:

  • • Historical analysis of trades from closed accounts
  • • Combining data from multiple time periods and accounts
  • • Offline analysis without API dependencies

How to Import

  1. Navigate to the Trading Analytics page
  2. Click the Import CSV button (green button with upload icon)
  3. Select your CSV file from the file picker
  4. The system validates the filename and imports the data
  5. Imported exchange appears in dropdown with 📊 (Imported) label
  6. All analytics charts update automatically

CSV File Requirements

  • • Must follow filename format: exchange_wallet_date.csv
  • • Must include all required columns (see CSV Export Format above)
  • • Duration format supports: 2h, 30m, 1.5d, 1w
  • • Exchange name must be at least 2 characters
  • • Date must follow format: YYYY-MM-DD

Merging Data

When you import a CSV for an exchange that already has imported data:

  • • System automatically detects existing data
  • • Merges new positions with existing data
  • • Deduplicates by: symbol + close timestamp + side
  • • Shows how many new positions were added
  • • Example: "Merged 45 new positions with existing PHEM data. Total: 105"

Tip: You can import multiple CSV files for the same exchange to build a complete historical dataset over time.

Virtual Exchanges

Imported exchanges are "virtual" - they exist only for analytics:

  • • No API keys required
  • • Only analytics and visualization
  • • Marked with 📊 (Imported) in dropdown
  • • Data stored in memory (not persistent across page refresh)

Analytics Features

Our Trading Analytics dashboard provides comprehensive tools to analyze your trading performance:

Statistics Cards

  • • Total PnL with color coding
  • • Win rate percentage
  • • Max drawdown calculation
  • • Average position duration
  • • Largest profit and loss
  • • Win/loss streaks

Charts

  • • Cumulative PnL line chart
  • • Drawdown visualization
  • • Win/loss streak chart
  • • Position duration chart
  • • Volume by symbol pie chart
  • • Daily PnL calendar heatmap

Period Filtering

  • • 30-day period slices
  • • Navigate between periods
  • • Each period has independent statistics
  • • Period labels show date ranges

Position History Table

  • • Pagination (30 positions per page)
  • • Sortable by close timestamp
  • • Color-coded PnL display
  • • Side badges (LONG/SHORT)
  • • Export buttons (CSV/PDF)

Best Practices

Regular Exports

Export your trade history regularly to maintain backups of your trading data, especially before making significant changes to your strategy or exchange accounts.

Consistent File Naming

Use consistent wallet identifiers in your filenames to easily organize and identify your exports (e.g., ABCD for main trading wallet).

Validate Imports

After importing, verify that the number of positions and statistics match your expectations. Check the charts and table for accuracy.

Period Review

Use the 30-day period filtering to analyze specific time ranges and identify patterns or trends in your trading performance.

Privacy Mode

Use the "Blur USD Values" toggle when sharing your screen or streaming to hide sensitive financial information while still showing relative performance.

Real-time Data

Comprehensive Market Data

Tetrac aggregates real-time market data from multiple leading cryptocurrency exchanges to provide you with the most accurate and up-to-date information:

  • Price updates for all supported cryptocurrencies across SPOT and FUTURES markets
  • Order book depth and real-time changes
  • Trade execution notifications and volume data
  • Open interest and funding rate information for futures markets
  • Market sentiment indicators and trending assets

Supported Exchanges

Our platform aggregates data from multiple leading cryptocurrency exchanges:

Aevo
Apex
Ascendex
Asterdex
Binance
Bingx
Bitget
Bitmart
Bitmex
Bitrue
Blofin
Bulktrade
Bybit
Coinbase
Dydx
Extended
Flash
Grvt
Hyperliquid
Kucoin
Lighter
Mexc
Okx
Orderly
Ostium
Pacifica
Paradex
Phemex
Propr
Reya
Standx
Variational
Vest
Woox

Data is refreshed every 60 seconds and cached for optimal performance while maintaining accuracy.

Advanced Data Filtering

Customize your market view with powerful filtering options:

  • Volume-based filtering to focus on high-liquidity markets
  • SPOT vs FUTURES market toggle
  • Search functionality to quickly find specific assets
  • Real-time sorting by price, volume, or change percentage

Customization

Multi-Device Support

Tetrac is designed to work seamlessly across all your devices:

  • Desktop: Full-featured trading terminal with advanced charting
  • Tablet: Optimized touch interface with essential trading tools
  • Mobile: Streamlined interface for on-the-go market monitoring

Advanced Charting & Data Views

  • Full screen tick charts for detailed price action analysis
  • Heat-map visualization for market overview and trending assets
  • Crypto screener with customizable filters and sorting options

Personalized Dashboard

Create your perfect trading environment with our customizable dashboard:

  • Favorite markets dashboard with integrated charts
  • Real-time tick-charts for quick price movements
  • Orderbook depth visualization for market insight

Dual Trading Interfaces

Choose the interface that matches your trading style:

Perp DEX Terminal

Simple UI designed for perpetual futures trading with essential tools

Multi-Terminal

Connect to multiple CEX | DEX to take control of several trading accounts. An advanced interface with comprehensive scanning tools for professional traders.

Visual Themes

Personalize your trading experience with our theme options:

  • Light Theme: Clean, bright interface for daytime trading
  • Dark Theme: Eye-friendly interface for extended trading sessions

Biometric Vault

PrivaC — Client-Side Encryption

All private keys (Solana, Orderly ed25519, EVM, EVM Signing) are AES-encrypted in your browser and never stored as plaintext. Decryption happens on-demand and is gated by WebAuthn passkeys — Touch ID or Face ID — so even XSS attacks cannot silently access your keys.

Your encryption key is derived deterministically from your credentials: a wallet signature for Web3 users, or a passkey for email users. It never touches our servers, never enters localStorage, and is cleared when you close the browser tab.

How It Works

01

Register & Derive Key

Sign up with email or connect a Web3 wallet. Your encryption key is derived via PBKDF2 — no passwords or KYC required.

02

Encrypt & Store

Wallets are generated automatically. Private keys are encrypted with AES-GCM (passkey) or AES-256 (string key) and stored in your browser.

03

Decrypt On-Demand

When a key is needed (signing an order, viewing credentials), it is decrypted in memory with biometric verification and discarded after use.

Security Guarantees

  • Biometric gating— Touch ID or Face ID required to decrypt any private key
  • Zero plaintext on server— wallets are created client-side, encrypted, and sent as encrypted blobs for backup. The server never sees plaintext keys
  • Memory-only encryption key— lives in memory only, backed by sessionStorage for page refreshes, cleared when you close the tab
  • Cross-platform— one set of encrypted credentials for Orderly Network, Vest Exchange, and all integrated platforms
⚠️

Biometric protection is not enabled by default.

To activate it, open Settings Panel → Authentication → Biometric Protection and click “Enable Touch ID Protection”. After enabling, you can configure auto-lock duration, lock-on-tab-switch, and migrate existing exchange credentials to passkey protection.

ℹ️

Learn more about the PrivaC encryption system on the dedicated PrivaC page.

Email Signin

Web3 Wallet Alternative

Tetrac offers a seamless email signin option for users who prefer not to use a Web3 wallet. This feature provides a simplified onboarding process while maintaining security and control over your assets.

  • No gas fees required for signin
  • No need for wallet setup or seedphrase management
  • No bridging or Dapp connections needed
  • No signature signing required for basic access

Security Features

Our email signin system maintains the highest security standards:

  • 100% Non-custodial - You retain full control of your assets
  • 100% On-chain trading - All transactions are recorded transparently
  • Enhanced Private Key Security - Keys are never stored unencrypted
  • Main Wallet Control - Your main wallet controls all asset actions

Getting Started

Register with any email address, no verfication code required. No email recovery possible. backup your main wallet private for both SVM and EVM. Signing wallets can be regenerated at anytime.

AsterDEX Integration

Overview

AsterDEX is an on-chain perpetuals exchange running on BNB Chain with 400+ USDT-margined markets and up to 125× leverage. TTC connects via the AsterDEX v3 REST API using EIP-712 typed-data signatures — the same wallet-based signing pattern used by Orderly Network and Pacifica.

ℹ️

AsterDEX uses an agent wallet pattern. Your main EVM/Solana wallet authorises a separate agent wallet to sign requests on its behalf. No API keys are issued — all authentication is on-chain via EIP-712 signatures on chainId 1666.

Key Features

400+ Perpetual Markets

USDT-margined perpetuals on BNB Chain covering major, mid, and long-tail pairs

Hedge & One-Way Mode

Full support for both position modes with correct positionSide mapping

Up to 125× Leverage

Cross margin with configurable leverage per symbol

EIP-712 Wallet Signing

Non-custodial — your agent private key never leaves your device

Account Setup

  1. Connect your wallet at asterdex.com — this becomes your User (main login wallet)
  2. Navigate to Account → PRO API and create a new agent wallet. AsterDEX generates a dedicated Signer address and its private key
  3. Download or copy the agent wallet credentials — the signer address and its private key
  4. Enter the three values into the TTC trading panel (see Credential Fields below)

Trading Panel Credentials

1

API Key → Signer address

The EVM address of the agent wallet created on AsterDEX (e.g. 0x21cF8Ae…). Used as the signer param on every signed request.

2

API Secret → Agent private key

The private key of the agent wallet (0x…). Used locally to produce EIP-712 signatures — never transmitted to AsterDEX servers.

3

Passphrase → User (main wallet address)

Your main EVM|Solana login wallet address (e.g. 0x63DD5a… or HgyfJf...). Sent as the user param on every signed request. This is your login wallet — not the signing agent wallet.

Quick Reference

DetailValue
TypeDecentralized Exchange (DEX)
ChainBNB Chain
CollateralUSDT
AuthEIP-712 — AsterSignTransaction domain, chainId 1666
NonceMicroseconds (µs timestamp)
Symbol FormatBTCUSDT, ETHUSDT
Funding IntervalEvery 8 hours
REST APIhttps://fapi.asterdex.com
Docsasterdex.github.io

BitMart Integration

Overview

BitMart is a centralized exchange offering USD-M perpetual futures on 200+ trading pairs. TTC connects via the BitMart Futures V2 REST API using HMAC-SHA256 signatures. A user-defined memo is required as part of every signed request.

ℹ️

BitMart requires a Memo — a passphrase you choose when creating the API key. Enter it in the Extra field. Without it every request will fail with an authentication error.

Key Features

200+ Perpetual Markets

USDT-margined perpetuals covering major and altcoin pairs

Hedge & One-Way Mode

Supports both position modes with correct side mapping

Up to 200× Leverage

Cross and isolated margin with adjustable leverage

Live Funding Rates

8-hour funding with next-period rate available in tickers

Account Setup

  1. Log in to BitMart → Account → API
  2. Click Create API Key and enable Futures Trading permissions
  3. Set a Memo — any string you choose (e.g. myTTCkey). You will need this exact value in the Extra field.
  4. Copy the API Key and Secret Key shown after creation

Trading Panel Credentials

1

API Key → Access Key

The API Access Key generated by BitMart. Sent as the X-BM-KEY header on every request.

2

API Secret → Secret Key

The Secret Key used to compute HMAC-SHA256 signatures. Never transmitted — used locally to sign each request.

3

Extra → Memo (required)

The memo passphrase you set when creating the API key. BitMart includes it in every signing string: timestamp#memo#body. Must match exactly what you entered on BitMart.

Quick Reference

DetailValue
TypeCentralized Exchange (CEX)
CollateralUSDT
AuthHMAC-SHA256 — timestamp#memo#body
Symbol FormatBTCUSDT, ETHUSDT
Funding IntervalEvery 8 hours
REST APIhttps://api-cloud-v2.bitmart.com
Docsdeveloper-pro.bitmart.com

Bitrue Integration

Overview

Bitrue is a centralized exchange offering 577+ USDT-margined perpetual futures contracts. TTC connects via Bitrue's Futures REST API using HMAC-SHA256 signatures over the timestamp + method + path + body payload. Three custom headers (X-CH-APIKEY, X-CH-TS, X-CH-SIGN) are sent on every authenticated request.

ℹ️

Bitrue's API quotes order sizes in contracts, not base-asset units. TTC's adapter converts using the per-contract multiplier from /fapi/v1/contracts so quantities you enter in the trading panel are in canonical base units (e.g. 0.01 BTC).

Key Features

577+ Perpetual Markets

USDT-quoted perps covering majors and a long tail of altcoins

Up to 125× Leverage

Cross and isolated margin selectable per contract

Limit, Market & Conditional Orders

LIMIT, MARKET, IOC, FOK, and POST_ONLY order types

Public Market Data

Tickers, depth, klines all available without an API key

Account Setup

  1. Log in to Bitrue → Account → API Management
  2. Click Create API Key and enable Futures Trading permissions
  3. Copy the API Key and Secret Key shown after creation — the secret is only displayed once
  4. (Recommended) Restrict the key to your IP address from the Bitrue API Management page

Trading Panel Credentials

1

API Key → API Key

The API Key issued by Bitrue. Sent as the X-CH-APIKEY header on every authenticated request.

2

API Secret → Secret Key

The Secret Key used to compute HMAC-SHA256 over timestamp + method + path + body. Never transmitted — used locally to sign each request.

3

Extra → (leave blank)

Bitrue's auth scheme uses only API Key and Secret. The Extra field is reserved for shape parity with other exchanges that require a passphrase or sub-account ID.

Quick Reference

DetailValue
TypeCentralized Exchange (CEX)
CollateralUSDT
AuthHMAC-SHA256 — ts + method + path + body
Symbol FormatE-BTC-USDT (native) BTCUSDT (canonical)
REST APIhttps://fapi.bitrue.com
Docsbitrue.com/api_docs_includes_file/futures

Bulk Trade Integration

Overview

Bulk Trade is a Solana-native perpetuals DEX offering BTC, ETH, SOL, XRP, and GOLD markets with up to 50× leverage. TTC connects via the Bulk Trade REST API using Ed25519 signatures derived from your Solana wallet — no API key registration required.

ℹ️

Bulk Trade uses your Solana wallet directly. Enter your wallet public key in the API Key field and your base58-encoded 64-byte secret key in the API Secret field. The Extra field is not used.

Key Features

Solana-Native DEX

Non-custodial, on-chain settlement using your Solana wallet

No API Key Registration

Sign directly with your Ed25519 keypair — no exchange account setup needed

Up to 50× Leverage

Cross-margin perpetuals on BTC, ETH, SOL, XRP, and GOLD

USDC Collateral

All positions margined and settled in USDC on Solana

Trading Panel Credentials

FieldValue
API KeyYour Solana wallet public key (base58)
API SecretYour Solana keypair secret key (base58-encoded 64-byte array)
ExtraLeave blank

Quick Reference

ChainSolana
CollateralUSDC
Symbol FormatBTC-USD
REST APIhttps://exchange-api.bulk.trade/api/v1
Docsdocs.bulk.trade

dYdX v4 Integration

Overview

dYdX v4 is a fully decentralized perpetuals exchange built on a custom Cosmos appchain. Trade 290+ markets with deep liquidity, no KYC, and full self-custody via your dYdX chain address.

ℹ️

dYdX v4 uses Cosmos-based addresses (dydx1...) and the indexer API for reading data. Order placement requires signing transactions on the dYdX chain.

Key Features

290+ Perpetual Markets

BTC, ETH, SOL, and hundreds of altcoin perpetuals

Hourly Funding Rates

Funding settles every hour (vs 8h on most CEXs)

No KYC Required

Fully decentralized — connect and trade

Deep Orderbook Liquidity

On-chain CLOB with tight spreads on major pairs

Account Setup

To start trading on dYdX v4, you need a dYdX chain account with USDC deposited and an API Trading Key for signing orders.

  1. 1.Create or import a dYdX chain wallet (Cosmos-based dydx1... address)
  2. 2.Deposit USDC to your dYdX subaccount (bridge from Ethereum, Arbitrum, or other supported chains)
  3. 3.Generate an API Trading Key from the dYdX web app (Settings → API Keys). This creates a separate wallet that can place/cancel orders on your behalf without withdrawal permissions.
  4. 4.Enter your dYdX address and API wallet private key in the Trading Panel to start trading

Trading Panel Credentials

When you select dydx in the Trading Panel, three fields are shown. dYdX v4 uses API Trading Keys— separate wallets that can place and cancel orders on behalf of your main account without withdrawal permissions.

1

API Key → Your dYdX Address

Your main dYdX account address (dydx1...) where your funds are deposited. Used by the indexer API to read your balance, positions, orders, and fill history.

2

API Secret → API Wallet Private Key

The private key (0x...) of your API Trading Key wallet. This wallet signs order and cancel transactions on behalf of your main account via dYdX's on-chain authenticator system. It cannot withdraw funds. Generate one from dYdX → Settings → API Keys. This key never leaves your browser.

3

Extra → Not used

Leave this field empty. It is not required for dYdX.

Quick Reference

DetailValue
ChaindYdX v4 (Cosmos appchain)
CollateralUSDC
Funding IntervalEvery hour
Symbol FormatBTC-USD, ETH-USD, SOL-USD
Indexer APIhttps://indexer.dydx.trade/v4
Docsdocs.dydx.exchange

Vest Markets

Overview

Tetrac integrates with VEST Markets, a decentralized perpetual exchange on Base network. To trade on VEST, Tetrac generates EVM-compatible wallets client--side upon registration. This section explains how to register with VEST, and bridge funds from Solana.

💡

For Solana Users: You can bridge USDC from Solana to Base and trade on VEST Markets.

EVM Wallet Types

Tetrac uses two types of EVM wallets for secure trading on VEST Markets:

🔵

Main Wallet

This wallet holds your funds on VEST Markets. It's the primary account that controls your trading balance.

  • • Holds your USDC balance for trading
  • • Receives funds from bridge transfers
  • • Authorizes the signing wallet
🟣

Signing Wallet

This wallet is authorized to sign transactions on behalf of your main wallet. It provides an extra layer of security as it never handles funds.

  • • Signs all trading transactions

Security Considerations

  • Local Storage: Keys are encrypted locally in your browser, biometric passkey unlocks them.
  • Never Share: Never share your private keys with anyone
  • Separation: Main and signing wallets are separate for enhanced security

VEST Markets Registration

Before trading on VEST Markets, you need to register your wallets. The registration process links your main wallet to your signing wallet.

Registration Steps

  1. Use the Generated or import your EVM wallets
  2. Click "Login" button
  3. Automatically receives your Account Group ID and API Key for signing

What You'll Receive

  • Account Group: Your unique VEST account identifier
  • API Key: For accessing VEST trading API

Bridge from Solana to VEST

Tetrac supports seamless USDC bridging from Solana to Base network for VEST trading. We use industry-standard bridge protocols for secure cross-chain transfers.

Wormhole CCTP

  • • Circle's Cross-Chain Transfer Protocol
  • • Native USDC transfers
  • • ~60 second bridge time
  • • No ETH required on Base

Mayan Finance

  • • MCTP/SWIFT integration
  • • Optimized routing
  • • Competitive fees
  • • Mobile-friendly with QR codes

How to Deposit

  1. Navigate to VEST trading page
  2. Click "Deposit to VEST" button
  3. Enter amount (minimum $1 USDC)
  4. Choose your deposit method:
    • • Mobile: Scan QR code with Phantom
    • • Desktop: Copy address and send
  5. Wait for bridge completion (~60 seconds)
  6. VEST automatically credits your account

What This Means for Solana Users

If you're primarily a Solana user, here's what you need to know:

Keep Your Solana Wallet

You don't need to abandon your Solana wallet. Use Phantom or other Solana wallets to hold your funds, then bridge USDC when you want to trade on VEST.

No ETH Required

Wormhole's executor handles gas fees on Base. You don't need to buy ETH to trade on VEST Markets.

EVM Wallets Generated Client-side For You

Tetrac can generate EVM wallets automatically. These are stored locally and used only for VEST trading.

⚠️

Minimum Deposit

The minimum bridge amount is $1 USDC. Smaller amounts will not process correctly.

Trading Panel Credentials

To place orders on VEST Markets through the Trading Panel, three credentials are required. After registration, these are stored locally and auto-filled when you select the VEST exchange.

1

VEST API Key

Received after registration. A JWT token that authenticates your requests to the VEST API.

2

Signing Wallet Private Key

The private key of your signing wallet (not your main wallet). Used to sign every order and cancellation.

3

Account Group ID

Your VEST account group number. In most cases this is 0.

Auto-Fill

If you registered through Tetrac, these credentials are already saved in your browser. When you select VEST in the Trading Panel, they will be filled in automatically.

Getting Started

Ready to start trading on VEST Markets? Follow these steps:

  1. 1.Sign in with email or connect your Web3 wallet
  2. 2.Use the Generated EVM wallets or import your own EVM wallets in dashboard
  3. 3.Register with VEST Markets (no gas required)
  4. 4.Bridge USDC from Solana to BASE chain
  5. 5.Send USDC to VEST!
  6. 6.Start trading!

Orderly Network

Orderly Network is an omnichain orderbook layer that powers multiple broker frontends. TTC connects to Orderly as a broker, giving you access to deep perpetual futures liquidity across 100+ markets.

How It Works

Orderly uses ed25519 trading wallets — a separate keypair from your main wallet. The trading wallet can place and cancel orders on your behalf but cannot withdraw funds. Your main wallet address is used to derive your Orderly account ID.

  • Trading wallet keypair is generated during Orderly's key registration flow
  • Each account is scoped to a broker ID — the same main wallet under different brokers produces different accounts
  • Collateral: USDC
  • Symbol format: PERP_BTC_USDC (normalized to BTCUSDT internally)

Trading Panel Credentials

When you select orderly in the Trading Panel, three fields are shown:

1

API Key → Trading Wallet Public Key

The ed25519 public key of your Orderly trading wallet (e.g. 5pCz54qHiax...). This is not your main Solana/EVM wallet address. The ed25519: prefix is added automatically — send the raw key.

2

API Secret → Trading Wallet Private Key

The ed25519 private key (hex string) of your trading wallet. Used to sign every authenticated request. This key never leaves your browser.

3

Passphrase → Broker ID

The broker your Orderly account is registered under (e.g. ttc, woofi_pro). Leave empty to default to ttc. Using the wrong broker ID will result in an account mismatch.

ℹ️

Main Wallet (4th credential)

Your main wallet address is used to derive your Orderly accountId via keccak256(walletAddress, brokerId).

  • Web3 users: Automatically injected from your ttc-public-key (your main wallet). No extra step needed.
  • Agentic / CLI users (email registration): Your ttc-public-key is a random DB identifier, not your Orderly wallet. Pass your real main wallet address as credentials.walletAddress in the API call.

Direct API Call

When calling POST /api/v1/exchanges for Orderly, send raw keys — the backend handles prefixing and account derivation:

{
  "exchangeName": "orderly",
  "method": "getPositions",
  "credentials": {
    "apiKey": "5pCz54qHiax4fw9ifNkt44uqqp7HjQ3...",
    "apiSecret": "c5306952a4fe14a776853efb8e26662d...",
    "passphrase": "ttc",
    "walletAddress": "J4b1gux..."
  },
  "params": {}
}

// walletAddress: your main Solana wallet (required for
// email-registered users, optional for web3 users)

Quick Reference

DetailValue
ChainOmnichain (EVM + Solana via NEAR)
CollateralUSDC
SigningEd25519 (trading wallet)
Symbol FormatPERP_BTC_USDC, PERP_ETH_USDC
Default Brokerttc
Docsorderly.network/docs

Flash Trade

Flash Trade is a Solana-native perpetuals protocol. Trade crypto, commodities, forex, and equities with up to 5x-500x leverage — all on-chain.

Key Features

  • 45+ markets: crypto, stocks (AAPL, TSLA, NVDA), commodities (XAU, XAG), forex (EUR, GBP)
  • No API keys required — all data endpoints are public
  • Trades execute as Solana transactions signed by your wallet
  • Oracle-powered pricing via Pyth Network

Trading Panel Credentials

Field 1 (API Key)Your Solana wallet public key (base58)
Field 2 (Secret)Not used — leave empty or enter any value
Field 3 (Extra)Not used — leave empty

Quick Reference

ChainSolana
CollateralUSDC
Symbol FormatBTC, SOL, ETH (bare symbols)
API URLhttps://flashapi.trade
Docshttps://docs.flash.trade

StandX

StandX is a perpetuals DEX with off-chain order book and on-chain settlement on Solana (SVM) and EVM chains. Authentication uses a JWT access token from off-chain sign-in combined with a per-request ed25519 body signature.

Key Features

  • Dual-chain support — sign in with a Solana (SVM) or EVM wallet
  • Two-layer auth: 7-day JWT access token + ed25519 body signature per request
  • Limit, market, stop, and reduce-only orders
  • USDC collateral

Account Setup

  1. Connect your wallet at app.standx.com and deposit USDC.
  2. Generate a session keypair locally (ed25519) and complete the off-chain sign-in flow via POST /v1/offchain/login. This returns a JWT valid for 7 days. See Create Session Key.
  3. Keep the session private key — it signs every request body. If it leaks, revoke the session and re-sign in.

Trading Panel Credentials

Field 1 (API Key)JWT access token from POST /v1/offchain/login (7-day expiry)
Field 2 (Secret)Hex ed25519 session private key used to sign request bodies
Field 3 (Extra)Optional x-session-id (must match WebSocket session)

Quick Reference

ChainSVM (Solana) or EVM
CollateralUSDC
Symbol FormatBASEUSDT internally; BASE-USD display
API URLhttps://api.standx.com
Docsdocs.standx.com

Ostium

Ostium is an on-chain perpetuals DEX on Arbitrum covering crypto, forex, commodities, and indices. All trades settle on Arbitrum smart contracts; account reads come from the Ostium subgraph and Pyth-backed price feed.

Key Features

  • On-chain perps on Arbitrum with USDC collateral
  • Multi-asset coverage — crypto (BTC, ETH, SOL…), forex, XAU/XAG, SPY, major equities
  • Market, limit, and stop orders with TP/SL attached on-chain
  • Up to ~100x leverage (asset-dependent)
  • No API keys — every trade is signed by an EVM private key and submitted as an Arbitrum transaction

Account Setup

  1. Fund an Arbitrum EVM wallet with USDC (collateral) and a small ETH buffer (gas).
  2. Export the wallet's private key. Tetrac stores it encrypted and uses it only to sign on-chain trades.
  3. In the Tetrac Trading Panel, select Ostium and paste the address into Field 1 and the private key into Field 2.

Trading Panel Credentials

Field 1 (API Key)Trader address — 0x… Arbitrum EVM address that holds USDC collateral and owns the open trades/limits.
Field 2 (Secret)EVM private key that signs trade transactions. Required for order placement, cancel, and close. Balance/position reads work without it.
Field 3 (Extra)Not used — leave blank

Quick Reference

ChainArbitrum One (EVM)
CollateralUSDC
Symbol FormatBTC-USD, ETH-USD, XAU-USD (normalised to BTCUSDT internally)
Price Feedhttps://listener.ostium.io/latest-prices
Subgraphapi.subgraph.ormilabs.com (ost-prod)
Docshttps://docs.ostium.io

Pacifica

Pacifica is a Solana-native perpetuals DEX with an off-chain order book and on-chain settlement. It uses Ed25519 signing via an API Agent Key so your main wallet never leaves your custody.

Key Features

  • Solana-native perpetuals with off-chain order book
  • API Agent Keys — a separate signing keypair authorised by your main wallet, generated at app.pacifica.fi/apikey
  • GTC limit orders, market orders, stop-limit, and stop-market
  • Cross and isolated margin modes
  • Subaccount support

Account Setup

  1. Connect your Solana wallet at app.pacifica.fi and deposit USDC collateral.
  2. Go to app.pacifica.fi/apikey and generate an Agent Wallet. Copy the base58 keypair.
  3. In the Tetrac Trading Panel, select Pacifica and paste the agent keypair into Field 2.

Trading Panel Credentials

Field 1 (API Key)Main account wallet address (Solana pubkey) — the wallet that holds your funds on Pacifica. This is used for all balance, position, and order queries.
Field 2 (Secret)Agent Wallet Keypair — base58-encoded 64-byte Solana keypair from app.pacifica.fi/apikey
Field 3 (Extra)Not used — leave blank

Quick Reference

ChainSolana
CollateralUSDC
Symbol FormatBTC, SOL, ETH (bare — normalised to BTCUSDT internally)
API URLhttps://api.pacifica.fi/api/v1
Docshttps://docs.pacifica.fi

GRVT

GRVT is a regulated hybrid CEX/DEX running a central limit order book off-chain with on-chain settlement on its own ZK-rollup. USDT and USDC are both supported as collateral and each has its own set of perpetual instruments.

Key Features

  • Three-domain API: edge (auth), trades (authenticated trading), market-data (public)
  • Cookie-based session auth — API key issues a short-lived gravity cookie that gates every trade call
  • USDT and USDC perpetuals on the same venue
  • Sub-account isolation — each API key is scoped to a single sub-account ID
  • EIP-712 signed order placement

Account Setup

  1. Sign up at grvt.io and complete KYC.
  2. Deposit USDT or USDC into a trading sub-account.
  3. In Account → API Keys, generate a key scoped to that sub-account. Note the sub-account ID shown next to the key.
  4. In the Tetrac Trading Panel, select GRVT and paste the API key, secret, and sub-account ID into Fields 1–3.

Trading Panel Credentials

Field 1 (API Key)API key string from grvt.io → Account → API Keys
Field 2 (Secret)API secret — used to mint the gravity session cookie on every login
Field 3 (Extra)Sub-account ID (numeric string) the API key is scoped to

Quick Reference

ChainGRVT ZK-rollup
CollateralUSDT, USDC
Symbol FormatBTC_USDT_Perp, ETH_USDC_Perp (normalised to BTCUSDT / ETHUSDC internally)
API URLedge.grvt.io, trades.grvt.io, market-data.grvt.io
Docshttps://api-docs.grvt.io

X402 Payments

Overview

Tetrac supports the x402 payment protocol for pay-per-request API access. If you don't have an API key, you can access any /api/v1/* endpoint by paying $0.05 USDC per request on Solana.

Price per Request

$0.05 USDC

Blockchain

Solana

Token

USDC

How It Works

The x402 protocol uses HTTP status code 402 (Payment Required) to enable machine-to-machine payments. When you call an API endpoint without an API key, the flow is:

1

Request the Endpoint

Call any /api/v1/* endpoint. If you don't have an API key, the server responds with 402 Payment Required and includes payment details (amount, wallet address, token).

2

Pay with USDC on Solana

Send 0.05 USDC to the treasury wallet address provided in the 402 response. Use any Solana wallet (Phantom, Solflare, etc.) or SDK.

3

Replay with Payment Proof

After the transaction confirms, resend your API request with the x-x402-payment header containing the transaction signature.

4

Receive Data

The server verifies the payment on-chain and returns the API data. Each payment is single-use.

Quick Example

Step 1: Call an endpoint without credentials:

curl -s https://ttc.box/api/v1/markets/news

Returns 402 with payment details including the treasury wallet address and price.

Step 2: After paying, replay with the payment header:

curl -s https://ttc.box/api/v1/markets/news \ -H "x-x402-payment: x402:<base64-encoded-payment>"

Payment Header Format

The x-x402-payment header contains x402: followed by a base64-encoded JSON object:

{
  "signature": "<solana-tx-signature>",
  "payer": "<your-wallet-address>",
  "amount": "50000",
  "timestamp": 1709827200000,
  "payTo": "2v4XjdTjHK7qKEc8BkCeCWFrZmGSJv32ZGyv27zw3jc5"
}

Amount is in microUSDC (50000 = $0.05). The payTo address is returned in the 402 response.

Available Endpoints

All /api/v1/* endpoints accept x402 payment. Key endpoints include:

/api/v1/markets/hybrid-tickers- Aggregated Tickers
/api/v1/markets/funding-rates- Funding Rates
/api/v1/markets/open-interest- Open Interest
/api/v1/exchanges- Agent Trading
/api/v1/markets/ttc-scanner- TTC Scanner

Security

  • On-chain verification: Every payment is verified directly on the Solana blockchain
  • Replay protection: Each transaction can only be used once (24-hour cache)
  • No keys on server: The server never holds or manages your private keys
  • Time-limited: Payments expire after 5 minutes for safety

API Key vs. X402 Payment

Tetrac API endpoints support dual authentication. Either method grants full access to the same data:

API Key (Free Tier)

  • • Register for free on Tetrac
  • • Unlimited requests (rate limited)
  • • Send ttc-auth-token and ttc-public-key headers

X402 Payment (Pay-per-Request)

  • • No registration needed
  • • $0.05 USDC per request on Solana
  • • Send x-x402-payment header

Subscription Tiers

Overview

Tetrac offers two paid tiers — Pro and Elite — purchased with Solana USDC via the x402 payment protocol. Subscriptions unlock higher API rate limits and premium product surfaces on top of the free tier.

Free

baseline limits

Pro

rate limit multiplier

Elite

10×

rate limit multiplier

Pricing

All prices are in USDC. Elite is priced at 2× Pro across every billing period.

BillingProElite
Daily$3$6
Monthly$88$176
Annual$777$1,554

Rate Limits

Each tier multiplies the per-endpoint baseline. Limits are evaluated per window (60s) per caller identifier (publicKey for authenticated users, payer wallet for x402 requests, or client IP).

EndpointFreeProElite
/api/v1/markets/*30/min90/min300/min
/api/v1/exchanges20/min60/min200/min

Exceeding a limit returns HTTP 429 with Retry-After, X-RateLimit-Tier, and X-RateLimit-Remaining headers.

Pro

  • • Full access to Pro Terminal
  • • DAO participation & position sharing
  • • MT5 Bridge
  • • 3× API rate limits on gated routes
  • • Priority x402 micropayment routing

Elite

  • • Everything in Pro
  • • 10× API rate limits on gated routes
  • • Elevated burst capacity for bulk trading
  • • Early access to experimental features
  • • Priority support channel

Activation

Subscriptions are settled on Solana mainnet in USDC. Once payment is confirmed, the tier is attached to your account's public key and applied automatically on every gated request — no API key swap required.

  • • Authenticated callers are keyed by their publicKey
  • • x402 one-shot callers rate-limit at the free tier by payer wallet
  • • Upgrading mid-window lifts the cap without resetting the counter

Solana Wallet Sweeper

Overview

The Solana Wallet Sweeper consolidates funds from multiple Solana wallets into a single destination address. It transfers all SPL tokens, closes empty token accounts to reclaim rent, and sends remaining SOL — all in one workflow.

Security: Private keys are never stored or transmitted — all signing happens locally in your browser.

How It Works

1

Set Destination

Enter the Solana wallet address where all funds will be consolidated.

2

Add Source Wallets

Add one or more wallets by entering both the public address and private key (base58). The tool validates that the key matches the address.

3

Fetch Balances

Click "Fetch" on each wallet to load SOL balance, SPL token balances, and detect empty token accounts with reclaimable rent.

4

Sweep

Sweep individual wallets or all at once. The tool closes empty accounts, transfers SPL tokens (creating destination ATAs as needed), and sends remaining SOL.

Features

Multi-Wallet Support

Add unlimited source wallets and sweep them all in one session.

SPL Token Transfer

Automatically detects and transfers all SPL tokens, creating ATAs on the destination if needed.

Rent Reclamation

Detects empty token accounts and closes them to reclaim ~0.00204 SOL per account.

Key Validation

Validates that each private key matches its public address before signing any transactions.

Access

Navigate to /crypto/solana-wallet-sweeper to use the wallet sweeper tool.

Solana Ledger Sweeper

Overview

The Solana Ledger Sweeper works with your Ledger hardware wallet to sweep funds and burn unwanted SPL tokens. All transactions are signed on the device — no private keys ever leave the hardware wallet.

🔒

Hardware Wallet Security: Every transaction must be confirmed on your Ledger device. Private keys never leave the hardware wallet.

Ledger Sweeper

Sweep SPL tokens and SOL from Ledger-derived addresses to a destination wallet. Optionally mark tokens for burning instead of transferring.

1

Connect Ledger

Connect your Ledger via USB, unlock with your PIN, and open the Solana app. Click "Connect Ledger" to establish the connection via WebUSB or WebHID.

2

Derive Addresses

Derive up to 20 addresses using the standard Solana BIP-44 derivation path m/44'/501'/x'/0'. Fetch balances to see SOL, SPL tokens, and empty accounts.

3

Set Destination & Sweep

Enter a destination address, then sweep individual wallets or all at once. Each transaction requires confirmation on your Ledger.

SPL Token Burner

Permanently destroy unwanted SPL tokens and reclaim the ~0.00204 SOL rent locked in each token account. This is a separate section from the sweeper — no destination wallet needed.

Irreversible: Burned tokens are permanently destroyed and cannot be recovered. Only burn tokens you are certain you no longer need.

1

Select Wallet

Choose a derived Ledger wallet from the dropdown.

2

Fetch & Select Tokens

Click "Fetch Tokens" to load all SPL tokens. Select individual tokens or use "Select All" to mark them for burning.

3

Burn & Reclaim

Click the burn button to execute. Each token is burned and its account closed in a single transaction, reclaiming rent SOL back to your wallet. Empty token accounts are also batch-closed.

Technical Details

Derivation Path

Uses standard BIP-44 m/44'/501'/x'/0' compatible with Ledger Live and Phantom.

Connection

Connects via WebUSB (primary) or WebHID (fallback). Requires Chrome or Edge browser.

Burn + Close

Each burn combines burnInstruction + closeAccountInstruction in one tx to destroy tokens and reclaim ~0.00204 SOL rent.

Batch Processing

Empty accounts are closed in batches of 10 per transaction to stay within Solana's transaction size limits.

Access

Navigate to /crypto/solana-ledger-sweeper to use the Ledger sweeper and token burner.

Changelog

Track all updates, new features, and bug fixes across releases.

View full changelog