Tetrac

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. They keep execution, analysis and account management for many venues in one place, so you spend less time switching between exchanges.

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.

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 that require trade history reporting, account management, and execution algorithms.
  • •Day traders looking for advanced execution, signals ranked by strength, self-custody on decentralized venues, and many venues in one terminal.
  • •Investors who want to monitor multiple assets and accounts across venues.
  • •Developers building trading applications and agents that want a plug and play environment for data and trading access.

Features

Tetrac is a multi-venue perpetual futures terminal spanning 41 exchanges (CEX and DEX), with WebSocket-first market data, automation and AI agents, machine-payable data endpoints, and wallet keys encrypted in your browser. Each entry below links to its documentation section or the feature itself.

Automation & AI

AI AgentsCreate, manage and chat with trading agentsAgent SkillsOpenClaw skill catalog agents can loadSignal CopierMirror signals into your own exchange account

Payments & Agent Rails

x402 MarketplacePay-per-request data endpoints in Solana USDCAgentic TradingMachine-payable pay-and-fetch flows for agents

Security & Wallets

Platform

Venue ComparisonSide-by-side CEX vs DEX fees, leverage and marketsArena1v1 duels and multi-player rumbles on live PnL

Mobile & Desktop App

Tetrac as a Progressive Web App

Tetrac is a Progressive Web App (PWA) — you can install it on your phone, tablet, or computer straight from the browser. No App Store, no Play Store, no download links. Once installed, Tetrac launches in its own window like a native app, with its own icon on your home screen, dock, or taskbar.

iOS (iPhone & iPad)

  1. 1.Open tetrac.xyz in Safari
  2. 2.Tap the Share button (the square with an arrow pointing up)
  3. 3.Scroll down and tap Add to Home Screen, then tap Add
  4. 4.Launch Tetrac from your home screen like any other app

Android

  1. 1.Open tetrac.xyz in Chrome
  2. 2.Tap the ⋮ menu in the top-right corner
  3. 3.Tap Add to Home screen (or Install app), then confirm with Install
  4. 4.Launch Tetrac from your home screen or app drawer

Desktop (Windows, macOS, Linux)

  1. 1.Open tetrac.xyz in Chrome, Edge, or Brave
  2. 2.Click the install icon at the right end of the address bar (or the browser menu → Install Tetrac)
  3. 3.Click Install — Tetrac opens in its own window
  4. 4.Pin it to your Dock or taskbar for one-click access

Why Install the Tetrac App?

  • •Native-app experience — full-screen standalone window with no browser tabs or address bar
  • •One-tap access from your home screen, dock, or taskbar — your charts and positions are seconds away
  • •Lightweight — installs in seconds with no app-store download or account required
  • •Always up to date — new features ship instantly with the web app, no store updates to wait for
  • •Same secure login, encrypted vault, and sessions as the browser — nothing to reconfigure

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 Tetrac's exchange tools — tickers, best bid/ask, balances, positions, orders, leverage, deposit addresses and withdrawals — 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. It requires a signed-in session; x402 payments are not accepted here.

Endpoint: https://www.tetrac.xyz/api/v1/mcp

Step 1 — Copy your MCP headers

Log in and go to the trading dashboard. In the bottom-right corner of the Dashboard header card, click MCP Headers. It copies only your two session headers, as JSON:

{
  "ttc-auth-token": "<your session token>",
  "ttc-public-key": "<your public key>"
}

Heads up: the session token expires 24 hours after you sign in. When tool calls start failing with 401, sign in again, click MCP Headers again and replace both values.

Step 2 — Add the server entry to your MCP client config

Open your MCP host's config file and add the server entry below to its mcpServers object, with the two copied values under headers. Pasting the copied JSON straight into mcpServers makes an invalid config. 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://www.tetrac.xyz/api/v1/mcp",
      "headers": {
        "ttc-auth-token": "<your session token>",
        "ttc-public-key": "<your public key>"
      }
    }
  }
}

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

  • 401 on connect or on every tool: the headers are missing, sit outside your server entry, or the 24-hour session expired. Sign in again, click MCP Headers, and replace both values inside the headers block of the TTC server entry.
  • 429 Rate limit exceeded: the MCP server allows 20 requests per minute per account. Wait for the Retry-After seconds.
  • Tool not showing up:your MCP client may have cached the old server. Fully restart it; don't just reload the window.

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 trading signals to your account on any supported exchange. The signal copier compares 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 API credentials for the exchange you copy to, configured via the desktop trading page.

Renko Autotrader

Settings you must not change while a position is open

Three settings are construction inputs: changing any of them rebuilds the trading machine from scratch rather than adjusting it. The interface will let you edit them at any time — nothing stops you — so this is the one rule worth knowing before you trade.

  • •Feed — the venue whose order book builds the bricks
  • •Symbol — the market being traded
  • •Brick % — the grid every price coordinate is measured against

Editing one of these while a position is open discards the running machine and starts a fresh one. Four things are lost, none of them visibly:

  • •Auto trading switches itself off. The new machine starts disarmed, so nothing manages the position until you turn it back on.
  • •The session PnL resets to zero. The daily loss limit is measured from it, so a limit that was nearly tripped starts counting again from nothing.
  • •Resting orders are abandoned. Your entry and protective stop still exist at the exchange, but the new machine holds no reference to them — so Cancel orders can no longer reach them. They have to be cleared from the exchange itself.
  • •The trail forgets its high-water mark. Trailing distance is measured from the best price seen since entry, and that history does not survive the rebuild.

Changing Brick % additionally re-scales the grid, so brick boundaries, pattern history and every stop level are recomputed against a different ruler.

Safe order of operations

  • •Close the position first — Flatten, or let the trailing exit take it.
  • •Confirm the top bar reads IDLE with no quantity.
  • •Then change Feed, Symbol or Brick %, and switch auto trading back on.

Everything else — Size, Trail, Lock, Clearance, Loss limit, Max stale, patterns and the side toggles — is applied to the running machine in place and is safe to adjust with a position open.

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 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 connects to these cryptocurrency exchanges (market-data coverage varies by endpoint):

ADEN
Adrena
Aevo
Arcus
AsterDEX
Binance
BingX
Bitfinex
Bitget
Bitrue
Blofin
Bulk.trade
Bullet
Bullish
Bybit
Coinbase
Decibel
DeepCoin
DojiFunded
dYdX
edgeX
Evedex
Extended
GMTrade
GRVT
Hibachi
Hyperliquid
Kraken Futures
KuCoin
Lighter
MEXC
OKX
Ondo Perps
Orderly Network
Ostium
Pacifica
Papertrade
Paradex
Phemex
Phoenix Eternal
Propr
Reya
Strike Finance
Vanta Trading
Variational
Veranta
Vest
WOO X
XBTFX

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
  • •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:

Chart Terminal

One market, in depth, on any supported venue. Three switchable views: a full-size price chart, a tick chart paired with a full depth ladder and time & sales, and an automated market maker that quotes both sides for you.

Pro Terminal

Many markets at once. Connect several CEX | DEX accounts side by side and drive them from one advanced interface with comprehensive scanning tools.

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

Telegram Controls

Drive the Chart from Telegram

Pair your own Telegram bot and control the app from any chat: switch the chart’s market with a message, check what’s currently loaded, and pull an on-demand Tetrac trade signal — entry, stop, targets and R:R — without leaving Telegram. It’s your bot and your chat: commands from any other chat are ignored.

A single polling loop runs app-wide (in the background, independent of which page you’re on), reads new messages every few seconds, and applies your commands to the shared chart symbol every open tab follows.

How It Works

01

Create & Pair a Bot

Make a bot with @BotFather and get your Chat ID from @userinfobot. Paste both into Settings.

02

Start Polling

Hit Startin the Telegram control. The vault decrypts your bot token in memory and the app begins reading messages — the plaintext token is never written to disk.

03

Send Commands

Message your bot /chart btc or /signal and the chart reacts within a few seconds.

Commands

/symbol <SYM> — alias /chart <SYM>

Switches the chart to that market and every open tab follows. Symbols are forgiving: btc becomes BTCUSDT (upper-cased, USDT appended if you omit the quote), while an explicit quote like solusdc is respected as-is. Unknown markets get an “Unknown symbol” reply.

/status

Replies with the symbol and timeframe currently loaded on the chart.

/signal [SYM]

Runs the Tetrac analysis engine on the market (defaults to the current one if you omit the symbol) and replies a formatted card: bullish/bearish score, suggested entry, stop-loss, take-profit targets and the risk-to-reward ratio.

Rate Limits

Because a bot can live in a public group, each command is throttled on a rolling 60-second window. Over the limit, the bot replies once with “Please slow down — wait Ns” and then stays quiet until the window clears (so a flood of commands can’t become a flood of replies).

1 / min

/chart + /symbol (shared)

10 / min

/signal

10 / min

/status

Security & Privacy

  • •Encrypted at rest, never on our servers — the bot token is saved in this browser only as ciphertext under your vault key. Once decrypted it stays in memory for the rest of your login session, so alerts keep running after the vault auto-locks, and it is dropped when you log out. Polling and replies go from your browser straight to Telegram.
  • •Vault-gated— the first start in a login session decrypts the token through the vault. If the vault is locked, the control shows “Unlock Vault” first.
  • •Chat allow-list— only messages from your configured Chat ID are acted on; anyone else in a shared group is silently ignored.
  • •No backlog replay— messages sent before you press Start are skipped, so an old command can’t fire the moment you connect.
  • •Read-only market data— commands change the chart and return analysis only. They never place orders or move funds.

Cross-Tab Symbol Sync

By default, the market you pick — from a chart dropdown or via a Telegram /chart command — is mirrored to every open tab through your browser’s local storage, so all your charts stay on the same symbol at once.

You can turn this off with the Cross-Tab Symbol Sync toggle in Settings Panel → Cross-Tab Symbol Sync. With it off, each tab keeps its own symbol independently and no longer follows the others. The preference is shared across your tabs and remembered between sessions.

💡

Turning sync off does not stop the bot. The tab running the polling loop still switches its own chart on a /chart command — that change is applied directly on the polling tab. Sync off only stops your other tabs from following along.

⚠️

The polling loop runs in one browser tab.

Telegram allows only one reader per bot token, so keep the tab you pressed Start on open. With Cross-Tab Symbol Sync on (the default), a /chart command updates your charts in every tab; with it off, only the polling tab changes. Either way, if that tab closes the bot stops responding until you Start again.

ℹ️

Configure your bot under Settings Panel → Telegram Alerts — enter the bot token and Chat ID, then use the Telegram control just below it to Start or Stop polling.

Biometric Vault

PrivaC — Client-Side Encryption

Your wallets (Solana and EVM, including the Orderly signing wallet) are generated in your browser, and each private key is encrypted there before it is uploaded. Our servers store only that ciphertext with your account and never receive the key that decrypts it.

The key that decrypts them (your app key) is derived in your browser from how you sign in: a signature from your Web3 wallet, PBKDF2 over your passkey phrase salted with your email, or the WebAuthn PRF output of a device passkey. It is held in memory only — never sent to our servers and never saved in localStorage — and the vault locks 60 seconds after you unlock it (some signing steps restart that timer). Reloading the page also drops it.

How It Works

01

Sign In & Derive Key

Sign up with an email and passkey phrase, a device passkey, or a Web3 wallet. Your browser derives the app key from that sign-in — no KYC required.

02

Encrypt & Store

Wallets are generated automatically. Private keys are encrypted in your browser and stored on our servers only as ciphertext.

03

Decrypt to Sign

When a wallet key must sign (an order, a transfer), it is decrypted in memory for that one signing call and discarded straight after. If the vault has locked, you unlock it first.

Security Guarantees

  • •Unlock per account type— a device-passkey account unlocks with your biometric or PIN check; a wallet account by signing with the wallet; an email account with your passkey phrase, unless you turn on Biometric Unlock (below)
  • •Zero plaintext on server— wallets are created client-side, encrypted, and stored on our servers only as ciphertext. The server never sees plaintext wallet keys
  • •Memory-only app key— held in memory while the vault is unlocked, never written to browser storage, and gone when the vault locks or the page reloads
  • •Exchange keys— API keys you save in the trading panel are encrypted under the same app key and kept in this browser. Once decrypted they stay in memory until you log out. Whether they are sent to Tetrac's server depends on the exchange's routing: see each exchange's section below
⚠️

Biometric Unlock is optional for wallet and email accounts.

To unlock with Touch ID or Face ID instead of signing or re-entering your phrase, open Settings Panel → Biometric Unlock, unlock the vault, and click “Enable Biometric Unlock”. This keeps a copy of your app key on this device, wrapped by the device passkey, so only your biometric check can unlock it. It appears only on devices with a biometric authenticator.

ℹ️

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 wallet signature prompts to sign in

Security Features

How an email account protects your keys and funds:

  • •Self-custody on decentralized venues - On decentralized venues your funds stay in your own wallet. On centralized exchanges, the exchange holds your balance and Tetrac trades it with the API keys you provide.
  • •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 verification code is required. There is no email recovery: Tetrac never sees your passkey phrase and cannot reset it, so back up the private keys of your Solana and EVM main wallets. Signing wallets can be regenerated at any time.

X402 Payments

Overview

Tetrac supports the x402 payment protocol for pay-per-request access to its paid market-data and exchange endpoints (listed below). Without a session, each call is paid in USDC on Solana: $0.05 per call, or $0.50 for /api/v1/markets/ttc-scanner-cache. /api/v1/markets is a free index that lists every market endpoint with its price. Other /api/v1 routes are not for sale.

Standard Price

$0.05 USDC

Blockchain

Solana

Token

USDC

Paid Endpoints

These endpoints accept x402 payment. Parameters, responses and errors for each are in the API reference.

GET /api/v1/marketsFree
GET /api/v1/markets/ttc-scanner$0.05
GET /api/v1/markets/ttc-scanner-cache$0.50
GET /api/v1/markets/hybrid-tickers$0.05
GET /api/v1/markets/funding-rates$0.05
GET /api/v1/markets/open-interest$0.05
GET /api/v1/exchanges$0.05
POST /api/v1/exchanges$0.05
GET /api/v1/markets/listings$0.05
GET /api/v1/markets/insights$0.05
GET /api/v1/markets/news$0.05
GET /api/v1/markets/calendar$0.05
GET /api/v1/markets/swap-volume$0.05
GET /api/v1/markets/volume-snapshot$0.05
GET /api/v1/markets/quakes$0.05
GET /api/v1/exchanges/latency$0.05
GET /api/v1/markets/symbol-venues$0.05
GET /api/v1/solana-perps/long-short$0.05
GET /api/v1/solana-perps/pacifica-watchlist$0.05

ttc-scanner-cache costs more because one call returns the whole multi-market Quadrant snapshot rather than one per-symbol result. Pass ?full=1 to receive the signals; without it the same price buys only the freshness timestamps.

How It Works

x402 uses HTTP status 402 (Payment Required) for machine-to-machine payment. When you call a paid endpoint without a session, the flow is:

1

Request the Endpoint

The server answers 402 Payment Required with an x402 v2 challenge (x402Version: 2, accepts, resource) in the body, and the same challenge base64-encoded in the payment-required header: the amount, the USDC mint and the payTo address.

2

Pay with USDC on Solana

Send the quoted USDC amount to the payTo address from your own wallet (Phantom, Solflare or an SDK). You sign the transfer and pay its network fee.

3

Replay with the Receipt

Resend the request with the canonical x402 v2 PAYMENT-SIGNATURE header (what stock x402 clients send), or the v1 x-x402-payment header, which is still supported.

4

Receive Data

The server verifies the payment on chain and returns the data. Each payment buys one call.

Quick Example

Step 1: Call a paid endpoint without a session:

curl -i https://www.tetrac.xyz/api/v1/markets/news

Returns 402 with the payment terms: amount, USDC mint and treasury address.

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

curl -s https://www.tetrac.xyz/api/v1/markets/news \ -H "PAYMENT-SIGNATURE: <base64-encoded-payment-payload>"

Payment Header Format

Canonical x402 v2. PAYMENT-SIGNATURE carries standard base64 of this JSON, with no prefix. accepted is the accepts entry you paid against, echoed unchanged:

{
  "x402Version": 2,
  "accepted": {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "50000",
    "payTo": "<payTo from the 402>"
  },
  "payload": {
    "signature": "<solana-tx-signature>",
    "payer": "<your-wallet-address>"
  }
}

Instead of a landed signature, the payload may be { transaction: <base64 signed transaction> }. The server relays it but never pays its fee, so your wallet must sign as the fee payer.

v1 (still supported). x-x402-payment carries x402: followed by base64 of this JSON:

{
  "signature": "<solana-tx-signature>",
  "payer": "<your-wallet-address>",
  "amount": "50000"
}

Amounts are micro-USDC (50000 = $0.05, 500000 = $0.50). Take the amount and the payTo address from the 402 response rather than hardcoding them.

MPP (Machine Payments Protocol)

Agents that speak MPP pay through one gateway: POST /api/v1/mpp (GET also works) with { method, path, parameters } naming the endpoint. The gateway answers with its own 402 (terms in the WWW-Authenticate: Payment header), charges USDC on Solana, then forwards the call and returns the data with a payment receipt. It sells the same endpoints at the same prices, and checks the request before charging.

{ "method": "GET", "path": "markets/hybrid-tickers", "parameters": "symbol=BTCUSDT" }

Full guide: MPP payments skill.

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 Tetrac key involved: You sign the transfer and pay its fee; the server never holds a key for your payment
  • •Time-limited: A transfer must be at most 5 minutes old when you present it

Session vs. X402 Payment

A signed-in session and an x402 payment unlock the same paid endpoints. Two things need a session: POST /api/v1/markets/ttc-scanner-cache (uploading the scanner snapshot) and the MCP server.

Session (Free Tier)

  • • Sign in for free on Tetrac
  • • Paid endpoints at no charge, within your tier's rate limits
  • • Send ttc-auth-token and ttc-public-key headers (the token lasts 24 hours)

X402 Payment (Pay-per-Request)

  • • No registration needed
  • • $0.05 USDC per call on Solana (see the exceptions above)
  • • Send the PAYMENT-SIGNATURE (or v1 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

1×

baseline limits

Pro

3×

rate limit multiplier

Elite

10×

rate limit multiplier

Pricing

All prices are in USDC. Elite is priced at 2× Pro, and is sold on monthly and annual billing only — the daily plan is a Pro-only option. Annual billing is 12× the monthly rate less 10%.

BillingProElite
daily$1.50—
monthly$44$88
annual$475$950

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
  • • 3× API rate limits on gated routes
  • • Priority x402 micropayment routing

Elite

  • • Everything in Pro
  • • Quadrant drawing tool & strategy bots
  • • 10× API rate limits on gated routes
  • • Elevated burst capacity for bulk trading

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.

ADEN Integration

Trading Panel Credentials

1

API Key → Key

The API Key issued under ADEN → API Management. Sent as the KEY header on every authenticated request. Note that ADEN's Perp DEX keys are separate from any other ADEN product key.

2

API Secret → Secret

The Secret shown ONCE at key-creation time. It computes the HMAC-SHA512 SIGN header over method + path + query + body-hash + timestamp; ADEN receives the signature, never the secret.

3

Passphrase → Leave blank

ADEN's auth scheme uses only the Key and Secret — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to ADEN, signing it where ADEN requires a signature, and does not store them.

Adrena Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Adrena docs for the API Key field.

2

API Secret → API Secret

Refer to the Adrena docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Adrena doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Aevo Integration

Trading Panel Credentials

1

API Key → Aevo API key (auto-filled)

Filled in for you by "Register with DEX": the app registers an Aevo signing key for your wallet and Aevo returns this key. Sent as the AEVO-KEY header. It reads your account and cancels orders; on its own it cannot place an order or withdraw. You can also paste a key created on Aevo's website.

2

API Secret → Aevo API secret (auto-filled)

Returned by Aevo together with the API key and sent as the AEVO-SECRET header. It is encrypted into your vault the moment it arrives.

3

Passphrase → Signing key (auto-filled)

The private key of the Aevo signing key minted in your browser during registration. It signs every order (EIP-712) and is encrypted into your vault. Aevo blocks browser calls from our domain, so your orders are placed from our server and this key is sent there to sign them. Its authority is trading only — withdrawals are signed by your wallet, not by this key. If you bring keys from Aevo's website, paste the signing key Aevo showed you (0x…). Your account address is read from Aevo with the API key, so there is no field for it.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Aevo, signing it where Aevo requires a signature, and does not store them.

Leverage

Leverage is set per market (up to 20x on the majors); the shield icon in the trading panel reads each market's live cap from Aevo.

Arcus Integration

Trading Panel Credentials

1

API Key → Ed25519 public key (auto-filled)

Filled in for you by "Register with DEX" — the same one-click flow every other DEX here uses. It mints an Ed25519 key pair in your browser and registers it to your wallet, so there is nothing to create or copy. Sent as the X-API-Key header. Only paste a value here if you are bringing a key you already registered with Arcus yourself (64 hex characters, no 0x).

2

API Secret → Ed25519 private key (auto-filled)

The private half of that generated pair. It is saved encrypted under your vault key, signs each order, and is never sent to Arcus. It cannot withdraw funds. If you are importing your own key, paste the 32-byte seed (64 hex characters) or the full 64-byte key (128 hex characters).

3

Passphrase → Ethereum address (auto-filled)

The address your Arcus account is keyed by — your auto-generated EVM funds wallet, which the app creates and manages for you. It holds your Arcus collateral and is where withdrawals are paid, which is why the account is rooted there rather than on the disposable order-signing key. Arcus looks up balances, positions and orders by this address. Leave the field alone unless you are importing an existing Arcus account.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Leverage

Leverage is set per market and capped by that market's initial-margin fraction — 40x on BTC-USD (2.5%), 25x on ETH-USD, and lower on equities. The shield icon in the trading panel reads the live cap and the real maintenance-margin ratio straight from Arcus. Note that Arcus gates trading behind an address access whitelist: until your address is granted access, orders are rejected with 403 even with a valid key.

AsterDEX Integration

Trading Panel Credentials

1

API Key → Signer address

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

2

API Secret → Agent private key

The private key of the agent wallet. It produces the EIP-712 signature on each request; AsterDEX receives the signature, never the key.

3

Passphrase → User — main wallet address

Your main EVM/Solana login wallet address. Sent as the user param on every signed request — this is your login wallet, not the signing agent wallet.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server. The trading panel opens on Lite; click the Lite badge in its header to switch.
  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to AsterDEX, signing it where AsterDEX requires a signature, and does not store them.

Binance Integration

Trading Panel Credentials

1

API Key → API Key

The API key created under Binance → Account → API Management. Sent as the X-MBX-APIKEY header on every authenticated request. Enable futures trading on the key for order placement.

2

API Secret → Secret Key

The secret shown once at key-creation time. It computes the HMAC-SHA256 signature appended to each signed request; Binance receives the signature, never the secret.

3

Passphrase → Leave blank

Binance authenticates with the key and secret alone — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Binance, signing it where Binance requires a signature, and does not store them.

BingX Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the BingX docs for the API Key field.

2

API Secret → API Secret

Refer to the BingX docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if BingX doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to BingX, signing it where BingX requires a signature, and does not store them.

Bitfinex Integration

Trading Panel Credentials

1

API Key → API Key

The key created under Bitfinex → Account → API Keys. Sent as the bfx-apikey header on every authenticated request. Grant it the Orders (read + write), Wallets (read) and Positions (read + write) permissions — derivative trading also needs Margin Trading enabled on the key.

2

API Secret → API Secret

The secret shown ONCE at key-creation time. It computes the HMAC-SHA384 bfx-signature header over /api/{path}{nonce}{body}; Bitfinex receives the signature, never the secret.

3

Passphrase → Leave blank

Bitfinex authenticates with the key and secret alone — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Bitfinex, signing it where Bitfinex requires a signature, and does not store them.

Bitget Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Bitget docs for the API Key field.

2

API Secret → API Secret

Refer to the Bitget docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Bitget doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Bitget, signing it where Bitget requires a signature, and does not store them.

Bitrue Integration

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 that computes the HMAC-SHA256 signature over timestamp + method + path + body; Bitrue receives the signature, never the secret.

3

Passphrase → Leave blank

Bitrue's auth scheme uses only the API Key and Secret — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Bitrue, signing it where Bitrue requires a signature, and does not store them.

Blofin Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Blofin docs for the API Key field.

2

API Secret → API Secret

Refer to the Blofin docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Blofin doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Blofin, signing it where Blofin requires a signature, and does not store them.

Bulk.trade Integration

Trading Panel Credentials

1

API Key → Solana wallet public key

Your Solana wallet public key (base58).

2

API Secret → Solana keypair secret key

Your Solana keypair secret key (base58-encoded 64-byte array).

3

Passphrase → Leave blank

Not used by BulkTrade — leave this field blank.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Bullet Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Bullet docs for the API Key field.

2

API Secret → API Secret

Refer to the Bullet docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Bullet doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Bullish Integration

Trading Panel Credentials

1

API Key → HMAC Public Key

The HMAC public key Bullish issues under Account → API Keys. It is prefixed literally with "HMAC-" followed by a UUID, e.g. HMAC-2f657a60-4b3c-4c3a-8e8f-106b137adf9e. Create an HMAC key, not an ECDSA key — only HMAC keys are supported here.

2

API Secret → HMAC Secret

The secret shown once when the HMAC key is created (UUID-shaped, single line). Store it immediately — Bullish will not show it again.

3

Passphrase → Trading Account ID (optional)

Optional. Bullish accounts can hold several trading accounts; paste the numeric Trading Account ID to pin one. Leave blank and your primary trading account is detected automatically.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Bullish, signing it where Bullish requires a signature, and does not store them.

Bybit Integration

Trading Panel Credentials

1

API Key → API Key

The API key created under Bybit → API Management. Sent as the X-BAPI-API-KEY header on every authenticated request. Grant it the Contract (Orders and Positions) permissions for trading.

2

API Secret → API Secret

The secret shown once at key-creation time. It computes the X-BAPI-SIGN signature over timestamp + API key + receive window + request payload; Bybit receives the signature, never the secret.

3

Passphrase → Leave blank

Bybit authenticates with the key and secret alone — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Bybit, signing it where Bybit requires a signature, and does not store them.

Coinbase Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Coinbase docs for the API Key field.

2

API Secret → API Secret

Refer to the Coinbase docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Coinbase doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Coinbase, signing it where Coinbase requires a signature, and does not store them.

Decibel Integration

Trading Panel Credentials

1

API Key → Trading Account address

Your Decibel TRADING ACCOUNT address (0x…), not your primary wallet. Find it at app.decibel.trade, or resolve it from your wallet via the subaccounts lookup. This is a PUBLIC on-chain address — Decibel needs no API key or secret for reads, and nothing you enter here can move funds.

2

API Secret → Trading Account address (paste it again)

Paste the SAME 0x… Trading Account address here. Decibel issues no API secret — reads are authorised by an application-level gateway key held on our servers — but the credentials form requires both fields to be filled before it will save, so the address goes in both. Order placement is an on-chain Aptos transaction that this integration does not perform.

3

Passphrase → Trading Account address (preferred slot)

Paste your 0x… Trading Account address here as well. This field is the one Decibel actually reads first, and unlike the two above it the value stays visible so you can check it against your wallet — nothing about this address is secret. Credentials saved before this field existed keep working: the API Key slot is still read as a fallback.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Decibel, signing it where Decibel requires a signature, and does not store them.

DeepCoin Integration

Trading Panel Credentials

1

API Key → API Key

The API Key string DeepCoin issues when you create an API key under DeepCoin → API Management.

2

API Secret → Secret Key

The Secret Key shown once, alongside the API Key, at key-creation time.

3

Passphrase → Passphrase (required)

A password you choose yourself when creating the DeepCoin API key — DeepCoin does not issue it.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to DeepCoin, signing it where DeepCoin requires a signature, and does not store them.

DojiFunded Integration

Trading Panel Credentials

1

API Key → Account ID

Your DojiFunded funded-account UUID (e.g. cc104636-0891-…). Identifies which funded account orders and reads run against.

2

API Secret → API token

Your DojiFunded bearer session token (v1.…). Sent as Authorization: Bearer and stored encrypted in the vault. Short-lived — regenerate it in DojiFunded when it expires.

3

Passphrase → Leave blank

Not used by DojiFunded — its auth is the account ID + bearer token only.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server. The trading panel opens on Lite; click the Lite badge in its header to switch.
  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to DojiFunded, signing it where DojiFunded requires a signature, and does not store them.
  • •The Perp Aggregator's best bid/ask read for DojiFunded needs your keys, so when you use the aggregator they are sent to Tetrac's server for that read.

dYdX Integration

Trading Panel Credentials

1

API Key → Your dYdX address

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

2

API Secret → API wallet private key

The private key (0x…) of your API Trading Key wallet — it signs order and cancel transactions via dYdX's on-chain authenticator system and cannot withdraw funds. Generate one from dYdX → Settings → API Keys.

3

Passphrase → Not used

Leave this field empty — it is not required for dYdX.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

edgeX Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the edgeX docs for the API Key field.

2

API Secret → API Secret

Refer to the edgeX docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if edgeX doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Evedex Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Evedex docs for the API Key field.

2

API Secret → API Secret

Refer to the Evedex docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Evedex doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Evedex, signing it where Evedex requires a signature, and does not store them.

Extended Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Extended docs for the API Key field.

2

API Secret → API Secret

Refer to the Extended docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Extended doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

GMTrade Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the GMTrade docs for the API Key field.

2

API Secret → API Secret

Refer to the GMTrade docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if GMTrade doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

GRVT Integration

Trading Panel Credentials

1

API Key → API key string

The API key string from grvt.io → Account → API Keys.

2

API Secret → API secret

The API secret — used to mint the gravity session cookie on every login.

3

Passphrase → Sub-account ID

The sub-account ID (numeric string) the API key is scoped to.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Hibachi Integration

Trading Panel Credentials

1

API Key → API Key

Created in the Hibachi UI under Settings → API Keys. Sent as the Authorization header. It authenticates only — it never signs an order.

2

API Secret → Private Key

The 0x-prefixed key Hibachi derived from your wallet signatures. It signs orders and withdrawals.

3

Passphrase → Account ID

Your numeric Hibachi Account ID — required, unlike most venues, because every authenticated request is scoped to it. IMPORTANT: Hibachi does not create this id until your FIRST DEPOSIT has landed, and it is shown ONLY inside the Hibachi UI (Main Account → ID) once funded. There is no API, wallet signature or derivation that can produce it, so deposit first, then read the id from their interface. It is a plain number — not your wallet address, and not the referral code from hibachi.xyz/r/…

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request, so a private key or secret entered here is never sent to Tetrac's server. Hibachi rejects browser calls from our site, so these requests pass through Tetrac's relay, which forwards the API-key header and the signed request to Hibachi and does not log or store them. The trading panel opens on Lite; click the Lite badge in its header to switch.
  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Hibachi, signing it where Hibachi requires a signature, and does not store them.

Hyperliquid Integration

Trading Panel Credentials

1

API Key → Main wallet address

The EVM address (0x…) of the Hyperliquid account that holds your USDC, equity, and positions. Find it in the Hyperliquid app under your account profile (top-right → click address). TTC uses it to query balances, positions, and orders for that account.

2

API Secret → API (agent) wallet private key

The 64-char hex private key (0x… prefix optional) of an API wallet you generate on Hyperliquid → top-right profile → API → Generate API Wallet. The agent key signs each order/cancel action via EIP-712 on behalf of your main wallet. It cannot withdraw funds.

3

Passphrase → Not used

Hyperliquid has no passphrase concept — leave this field empty. (Only OKX-family venues use a passphrase.)

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server. The trading panel opens on Lite; click the Lite badge in its header to switch.
  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Hyperliquid, signing it where Hyperliquid requires a signature, and does not store them.

Kraken Futures Integration

Trading Panel Credentials

1

API Key → API Key

The public API key from Kraken Futures → Settings → API Keys. Sent as the APIKey header on every authenticated request.

2

API Secret → API Secret (private key)

The base64 private key issued alongside the API key. It computes the Authent signature (SHA-256 + HMAC-SHA-512); Kraken receives the signature, never the key.

3

Passphrase → Leave blank

Kraken Futures authenticates with only the API Key and Secret — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Kraken Futures, signing it where Kraken Futures requires a signature, and does not store them.

KuCoin Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the KuCoin docs for the API Key field.

2

API Secret → API Secret

Refer to the KuCoin docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if KuCoin doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to KuCoin, signing it where KuCoin requires a signature, and does not store them.

Lighter Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Lighter docs for the API Key field.

2

API Secret → API Secret

Refer to the Lighter docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Lighter doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

MEXC Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the MEXC docs for the API Key field.

2

API Secret → API Secret

Refer to the MEXC docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if MEXC doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to MEXC, signing it where MEXC requires a signature, and does not store them.

OKX Integration

Trading Panel Credentials

1

API Key → API Key

The API key created under OKX → API. Sent as the OK-ACCESS-KEY header on every authenticated request. Give it the Trade permission for order placement.

2

API Secret → Secret Key

The secret key shown once at key-creation time. It computes the OK-ACCESS-SIGN signature on each request; OKX receives the signature, never the secret.

3

Passphrase → Passphrase (required)

The passphrase you chose when creating the OKX API key. Sent as the OK-ACCESS-PASSPHRASE header, and required for every signed request.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to OKX, signing it where OKX requires a signature, and does not store them.

Ondo Perps Integration

Trading Panel Credentials

1

API Key → Ondo session token (JWT)

The JWT minted by signing Ondo's SIWE challenge with your wallet. This is the credential TTC uses; the token expires, so you re-sign when it lapses. Ondo also has an API-key scheme, but it needs their team to enable key management on your account and they publish no signing spec, so it is not wired up here.

2

API Secret → Ondo account ID

The account ID returned alongside your session token when you sign in. Filled in automatically by the Ondo login flow — it is an identifier, not a secret.

3

Passphrase → Not used

Not used by Ondo Perps — leave this field empty.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Ondo Perps, signing it where Ondo Perps requires a signature, and does not store them.

Orderly Network Integration

Trading Panel Credentials

1

API Key → Trading wallet public key

The ed25519 public key of your Orderly trading wallet — not your main Solana/EVM wallet address. The ed25519: prefix is added automatically, so enter the raw key.

2

API Secret → Trading wallet private key

The ed25519 private key (hex string) of your trading wallet. It signs every authenticated request.

3

Passphrase → Broker ID

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

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server. The trading panel opens on Lite; click the Lite badge in its header to switch.
  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Orderly Network, signing it where Orderly Network requires a signature, and does not store them.
  • •The Perp Aggregator's best bid/ask read for Orderly Network needs your keys, so when you use the aggregator they are sent to Tetrac's server for that read.

Ostium Integration

Trading Panel Credentials

1

API Key → Trader address

The 0x… Arbitrum EVM address that holds your USDC collateral and owns the open trades and limit orders.

2

API Secret → EVM private key

The EVM private key that signs trade transactions. Required for order placement, cancel, and close — balance and position reads work without it.

3

Passphrase → Not used

Not used by Ostium — leave this field blank.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Pacifica Integration

Trading Panel Credentials

1

API Key → Main account wallet address

Your main account wallet address (Solana pubkey) — the wallet your agent key is bound to. Used for all balance, position, and order queries unless a vault address is set in the Passphrase field.

2

API Secret → Agent wallet keypair

A base58-encoded 64-byte Solana keypair generated from app.pacifica.fi/apikey.

3

Passphrase → Vault address (optional)

Leave blank to trade your main account. To trade a Pacifica vault you manage, paste the vault's address.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server. The trading panel opens on Lite; click the Lite badge in its header to switch.
  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Pacifica, signing it where Pacifica requires a signature, and does not store them.

Papertrade Integration

Trading Panel Credentials

1

API Key → EVM funds wallet address (auto-filled)

Auto-filled when you press Enable trading on the exchange-login surface: your EVM funds wallet address (0x…) is your Papertrade account identity and scopes every balance/position read. Never paste anything here.

2

API Secret → No secret — leave blank

There is no API key or secret to paste. Trading is enabled in-app with your own wallets: one signature registers a 30-day session key, and every order signs locally in your browser. This field stays reserved for a possible future paste fallback.

3

Passphrase → Not used

Not used by Papertrade. (Order submission goes through our own /api/v1/papertrade/intents route — PT's relayer serves no CORS headers, so direct browser submission is impossible; papertrade_api_extra stays reserved for an optional https direct-endpoint override.)

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Paradex Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Paradex docs for the API Key field.

2

API Secret → API Secret

Refer to the Paradex docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Paradex doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Phemex Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Phemex docs for the API Key field.

2

API Secret → API Secret

Refer to the Phemex docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Phemex doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Phemex, signing it where Phemex requires a signature, and does not store them.

Phoenix Eternal Integration

Trading Panel Credentials

1

API Key → Solana main-wallet address

Your main wallet address (Solana pubkey) — the trader `authority` on Phoenix Eternal. Used for all balance, position, and order queries; these reads are public, so no login is required.

2

API Secret → Solana signing key

The Solana keypair that signs Phoenix transactions. Only the order write path uses it (a later release); the current read-only integration does not need it.

3

Passphrase → Not used

Not used by Phoenix — leave this field blank.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Propr Integration

Trading Panel Credentials

1

API Key → API Key

Your Propr API key (pk_live_… / pk_beta_…) from your Propr account. Sent as the X-API-Key header on every request.

2

API Secret → Account ID

Your Propr Account ID (urn:prp-account:…) — the funded challenge account to trade. Get it from the Propr page after entering your API key (the account picker), then paste it into this field.

3

Passphrase → Leave blank

Not used by Propr — leave this field blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Propr, signing it where Propr requires a signature, and does not store them.

Leverage

Max leverage: 5x on BTC and ETH, 2x on all other crypto.

Reya Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Reya docs for the API Key field.

2

API Secret → API Secret

Refer to the Reya docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Reya doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Strike Finance Integration

Trading Panel Credentials

1

API Key → X-API-Wallet-Public-Key

Your API wallet's Ed25519 PUBLIC key — 64 hex characters. Create the key pair on the API Keys page of app.strikefinance.org and register the public half there.

2

API Secret → API wallet private key

The matching Ed25519 PRIVATE key, 64 hex characters (a 32-byte seed) or 128 (a 64-byte expanded key). It signs each request. SSH-format keys (ssh-ed25519 AAAA…) are not accepted. An API wallet can trade but can NEVER withdraw.

3

Passphrase → Vault ID (optional)

Optional vault UUID. Leave blank to trade your personal account. Set it to a vault you LEAD and every order, cancel and balance read is routed to that vault instead — the same API key does both.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Vanta Trading Integration

Trading Panel Credentials

1

API Key → Key ID

The vk_… key id shown when you create the key in Vanta under Settings → Key Management. It identifies which secret Vanta verifies against and is not itself a secret. Up to 3 active keys per account.

2

API Secret → Key Secret

The key secret, displayed ONCE at creation. It signs an HMAC-SHA256 of each request; Vanta receives the signature, never the secret. Lose it and you must revoke the key and issue a new one.

3

Passphrase → Account ID (optional — leave blank)

Leave blank. Each Vanta key is bound to exactly one prop account, so we read the bound account id from Vanta automatically. Only fill this in if you want to pin a specific account UUID; a value that does not match the key's binding is rejected with 403.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to Vanta Trading, signing it where Vanta Trading requires a signature, and does not store them.

Variational Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the Variational docs for the API Key field.

2

API Secret → API Secret

Refer to the Variational docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if Variational doesn't require one.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Veranta Integration

Trading Panel Credentials

1

API Key → Trader address (optional)

The Base address your positions and collateral belong to. Leave blank to use the signing key's own address — only set it when signing on behalf of a different trader (Veranta delegate mode).

2

API Secret → EVM private key

The Base (chain 8453) private key that signs your trade intents with an EIP-712 signature. Veranta only ever receives the signature, never the key.

3

Passphrase → Leave blank

Not used by Veranta — leave this field blank.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request itself. These credentials are not sent to Tetrac's server.

Vest Integration

Trading Panel Credentials

1

API Key → VEST API Key

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

2

API Secret → Signing wallet private key

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

3

Passphrase → Account Group ID

Your VEST account group number — in most cases this is 0.

Where These Credentials Go

  • •Lite routing (browser): your browser signs each request, so a private key or secret entered here is never sent to Tetrac's server. Vest rejects browser calls from our site, so these requests pass through Tetrac's relay, which forwards the API-key header and the signed request to Vest and does not log or store them.

WOO X Integration

Trading Panel Credentials

1

API Key → API Key

Refer to the WOO X docs for the API Key field.

2

API Secret → API Secret

Refer to the WOO X docs for the API Secret field.

3

Passphrase → Optional

Optional — only required by exchanges that issue an extra passphrase alongside the key/secret (e.g. OKX). Leave blank if WOO X doesn't require one.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to WOO X, signing it where WOO X requires a signature, and does not store them.

XBTFX Integration

Trading Panel Credentials

1

API Key → API Key

The Bearer API key created at console.xbtfx.com (requires an MT5 Edge or ECN account). Sent as the Authorization: Bearer header on every request — XBTFX does not use request signing.

2

API Secret → Leave blank

XBTFX authenticates with the Bearer API key alone — there is no secret to sign with. Leave this field blank.

3

Passphrase → Leave blank

Not used by XBTFX — leave blank.

Where These Credentials Go

  • •Pro routing (server): your browser sends these credentials to Tetrac's server over TLS with every request. The server uses them to authenticate that request to XBTFX, signing it where XBTFX requires a signature, and does not store them.
  • •The Perp Aggregator's best bid/ask read for XBTFX needs your keys, so when you use the aggregator they are sent to Tetrac's server for that read.

Changelog

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

View full changelog