The SYMMIO SDK · HyperEVM

Build on SYMMIO — without the complexity.

One SDK for the entire protocol surface. @symmio/trading-core and trading-react wrap contracts, solvers, prices, and Muon behind a simple, correct, reliable API — so you build the interface, not the plumbing.

Get started Read the docs

TypeScript-native
Framework-agnostic core
MIT licensed

ticket.tsx

1import { useMarket } from "@symmio/trading-react";23export function Ticket() {4  const { market, mark } = useMarket("BTC-PERP");56  return (7    <OrderTicket8      symbol={market.symbol}9      price={mark}10      maxLeverage={market.maxLeverage}11    />12  );13}

₿

BTC-PERPBitcoin Perpetual

HyperEVM

$63,214.20+2.14% · 24h

Mark63,214.20

Funding0.011%

Max lev.50×

LongShort

Size0.35 BTC

Leverage2.5×

Place long order

positions.tsx

1import { usePositions } from "@symmio/trading-react";23export function Positions() {4  const { positions } = usePositions();56  return (7    <PositionList8      rows={positions}9      onClose={(id) => close(id)}10    />11  );12}

Open positions3

live

BTC-PERPLong 2.5×
0.35 BTC
+$418.02+1.9%
HYPE-PERPLong 10×
1,240 HYPE
+$1,204.60+7.4%
ETH-PERPShort 5×
2.1 ETH
-$62.14-0.8%

Net unrealized+$1,560.48

balance.tsx

1import { useAccount } from "@symmio/trading-react";23export function Balance() {4  const { equity, available } = useAccount();56  return (7    <Collateral8      equity={equity}9      available={available}10    />11  );12}

Account0x8f…2ad1

Settled

Account equity$12,480.55

Available$8,214.30

In use$4,266.25

Allocated34%

Deposit

Withdraw

compose.tsx

1import {2  useMarket,3  usePositions,4  useAccount,5} from "@symmio/trading-react";67export function AnyUI() {8  // any hooks, any layout — compose9  // the exact UI your product needs1011  return <YourDesign />;12}

Building blockstrading-react

40+ hooks

Mix any hooks into your own components — no fixed component set.

useMarketusePositionsuseAccountusePricesuseQuotesuseDeposituseOrdersuseMuonuseBalances+ 30 more

Your componentsCompose your own

Order ticket

Contract methods
Solver markets
Enigma prices
Muon attestations
Subgraph history
Deposit / withdraw
Quote reconciliation
Session keys
WebSocket feeds
Chain config

The SDK

Two layers. One is framework-agnostic on purpose.

trading-core holds every contract call, GraphQL query, and calculation with no framework assumptions. trading-react is a thin layer of hooks and providers on top. Keep core reusable and a Vue or Solid layer slots in later without a rewrite.

Correct by construction — typed errors, validation, and calculations live once, in core.
Reusable everywhere — no React in core means the next framework layer is additive.
Thin React ergonomics — trading-react only adds what genuinely needs component state.

Your UIapps/web, or your own product

ReactVuesoonSolidsoon

@symmio/trading-reactReact layerHooks · Providers · Stateful flows

@symmio/trading-coreFramework-agnostic coreContract calls · GraphQL · Calculations · Transforms

SYMMIO protocolContracts · Solvers · Enigma prices · Muon

Simple

One surface, not many

The same calls third-party builders use — no vendor-specific glue, no bespoke contract wiring to maintain.

Correct

The compiler catches it

Typed errors, input validation, and calculations verified against the perps-core contracts, cited in the docs.

Reliable

Consistency handled for you

Realtime feeds, quote reconciliation, retries, and reconnection live inside the SDK — your UI just reads state.

Libraries

Five packages. Pick what you need.

Each is published, typed, and documented on its own. Install the core, add the React layer, reach for signing and utils as you go.

All docs

Core

@symmio/trading-core

The framework-agnostic base — contract reads and writes via viem, REST and GraphQL calls, and the calculations that turn raw protocol data into typed results.

viemGraphQLcalculations

Docs

React

@symmio/trading-react

The React layer — hooks and a provider that bridge core to your wagmi and TanStack Query setup. Read positions, quotes, balances, and prices without wiring contract calls.

hooksproviders

Docs

Signing

@symmio/session-key

Local EVM session keys — generation, import, runtime manager state, and EIP-712 signing. Persistence and encryption stay in your app.

EIP-712local

Docs

Utils

@symmio/utils

Framework-neutral primitives — token amount formatting, display formatters, address shorteners, and a Decimal.js bridge.

formatDecimal.js

Docs

Design

@symmio/ui

The design system behind our own apps — accessible, Radix-based primitives on Tailwind. Used by our surfaces; not required to consume the SDK.

RadixTailwind

Docs

Open source

Read the source

Every package lives in one monorepo. Browse the code, the tests, and the design docs on GitHub.

View repository

Apps

Built on the same SDK you'd use.

Our own surfaces consume trading-core and trading-react exactly the way a third-party integrator would — the console is the reference implementation.

Web console

apps/web

Connect a wallet and drive every SDK call live — contract reads and writes, deposits and withdrawals, quotes and positions.

Open

Documentation

apps/docs

The full API reference — every hook, type, and function, with runnable examples and the concepts behind them.

Open

Storybook

apps/storybook

Browse @symmio/ui in isolation — every primitive, every state, fully interactive.

Open

Get started

Three steps to your first read.

Install the packages, wrap your app in the provider once, then read positions, quotes, balances, and prices with hooks. Bring your own wagmi and TanStack Query setup — the SDK bridges to it.

Read the docs Open the console

MIT licensed · works with wagmi + TanStack Query · TypeScript-native

quickstart

1
Install the packages
$ pnpm add @symmio/trading-core @symmio/trading-react
2
Wrap your app once
<SymmioProvider> … </SymmioProvider>
3
Read protocol state with hooks
const { positions } = usePositions();