# HELIX · listing kit

Drop-in answers for every aggregator listing form. Copy-paste the relevant block — fields marked `<TBD>` get populated once the contract is live.

> Public-facing brand kit: <https://skew-production.up.railway.app/brand>
> Logo assets: [`brand/`](./brand) (SVG + transparent PNG, 64 → 1024)

---

## Protocol facts

| Field | Value |
| --- | --- |
| DEX name | **HELIX** |
| Project type | Perpetual DEX · hook-native |
| Website | https://skew-production.up.railway.app |
| App / swap URL | https://skew-production.up.railway.app/trade |
| Statistics URL | https://skew-production.up.railway.app/stats |
| Leaderboard URL | https://skew-production.up.railway.app/leaderboard |
| Risk engine doc | https://skew-production.up.railway.app/risk |
| Whitepaper | https://skew-production.up.railway.app/paper |
| Developer docs | https://skew-production.up.railway.app/docs |
| Onchain explorer | https://skew-production.up.railway.app/explorer |
| Chain | Base mainnet (chain id 1) |
| Margin asset | USDC (`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`, 6 dec) |
| Markets | 24 perp markets at launch |
| Max leverage | 25× majors · 10× alts |
| Maintenance margin | 2% majors · 5% alts (immutable constants) |
| Liquidation bounty | 1.00% of notional (paid to keeper) |
| Funding clamp | ±0.005% / hr (≈ ±43.8% APR worst case) |
| HLP drawdown gate | 8% from peak (withdrawals pause above) |
| Governance | None — contract has no owner, no proxy, no upgrade key |
| Audits | In progress (see `contract/INTERNAL_AUDIT.md`) |
| License | Source-available · open for redistribution |
| Contact | team@helix.trade |

## Deployment addresses

> Populated automatically on contract deploy via `HELIX_CONTRACT`, `HELIX_TOKEN`, `HELIX_HOOK` env vars. Until then these are `<TBD>` and the `/api/health` endpoint reports `mode: mock`.

| Contract | Address | Etherscan |
| --- | --- | --- |
| HelixPerps (core engine) | `<TBD>` | `<TBD>` |
| HelixHook (v4 hook) | `<TBD>` | `<TBD>` |
| $HELIX token (ERC-20, 1B fixed supply) | `<TBD>` | `<TBD>` |
| HLP vault | same address as HelixPerps (single contract) | — |
| Pool manager (Uniswap v4) | canonical mainnet PM | — |

---

## Logo / icon assets

All assets are in [`brand/`](./brand). Transparent backgrounds, both SVG (vector) and PNG (raster at 64/128/256/512/1024).

| Use case | File |
| --- | --- |
| Aggregator favicon / square icon | `brand/helix-mark-128.png` |
| Aggregator card / token list | `brand/helix-mark-256.png` |
| Press / partner header | `brand/helix-lockup-1024.png` |
| Vector master | `brand/helix-mark.svg` |
| On-black variant | `brand/helix-mark-on-dark.svg` |
| On-light variant | `brand/helix-mark-on-light.svg` |
| Monochrome (single-color print) | `brand/helix-mark-mono-{light,dark}.svg` |

Live preview + downloads: <https://skew-production.up.railway.app/brand>

## Colors

| Token | Hex | Use |
| --- | --- | --- |
| HELIX mint | `#97fce4` | Single brand accent · use sparingly |
| HELIX mint deep | `#5fb8a3` | Mint variant for light backgrounds |
| Ink black | `#000000` | Canvas · primary background |
| Ink light | `#f4f6fb` | Body text on dark · primary foreground |

HELIX is a **single-accent** brand. Mint is the only saturated color; everything else is grayscale. Status colors (red/green/amber) follow the standard PnL/health semantics and are not "brand" colors.

## Fonts

- **Primary** — IBM Plex Mono · weights 400/500/600/700 · headlines, numerics, navigation
- **Body** — IBM Plex Sans · weights 300/400/500/600 · long-form copy
- **Display** — Schibsted Grotesk · used only on the home hero (optional)

All available on Google Fonts; CDN URLs in every `.html`.

---

## Press copy (drop-in)

### One-liner (≤ 80 chars)

> Hook-native perp DEX on Base. 24 markets, USDC margin, no admin.

### Short (≤ 240 chars)

> HELIX is a perpetual DEX built directly on Base's primary AMM. Mark price is the live pool price — no off-chain oracle, no admin, no upgrade key. 24 markets, 25× max leverage, cross-margined USDC. HLP backstop earns 50% of all fees.

### Long (≤ 500 chars)

> HELIX is a hook-native perpetual DEX on Base mainnet. A single v4 hook turns the canonical USDC pool into a perp engine — every position settles against the same liquidity the spot market trades on. The contract has no owner, no proxy, no governance: every parameter (margin tiers, liquidation bounty, funding clamp, HLP drawdown gate) is a public constant. Liquidations route 1% to whoever calls liquidate(); the rest is absorbed by HLP. $HELIX captures 50% of all fees via buyback-and-burn.

### Taglines

- every position curves.
- perps that live inside the pool.
- one hook, one engine, no admin.
- mark price = pool price.

---

## API for aggregators

Every aggregator that wants live data can hit the read-only JSON API. No auth, CORS open, all numbers in human-readable units.

| Endpoint | Shape | Refresh |
| --- | --- | --- |
| `GET /api/health` | `{ ok, block, markets, mode, chain }` | — |
| `GET /api/markets` | per-market `{ sym, px, oi, chg24h, funding1h, vol24h, … }` | every block |
| `GET /api/markets/:sym` | single market + 60-pt price history | every block |
| `GET /api/stats` | aggregate OI, vol24h, fees24h, traders24h, trades24h | every block |
| `GET /api/funding` | per-market hourly funding rate + direction | every block |
| `GET /api/trades?limit=N` | last N trade events (block, side, market, size, lev) | streaming |
| `GET /api/liquidations?limit=N` | last N liquidation events | streaming |
| `GET /api/hlp` | `{ tvl, shares, sharePx, apr7d, drawdownPct, peakTvl }` | every block |
| `GET /api/leaderboard?window=7d|30d|all` | top traders by PnL | every block |
| `GET /api/token` | `{ supply, burned, float, stakers, feeShareBps }` | every block |
| `GET /api/position?wallet=0x…` | per-wallet open positions | every block |

The same endpoints return mock data pre-deploy (`mode: "mock"`) so integrators can build against the live schema today.

---

## Forum / listing post · paste-and-go template

Use this verbatim for DexScreener, Dextools, Birdeye, GeckoTerminal, CMC, CoinGecko submission forms:

```
DEX Name:           HELIX
DEX Website:        https://skew-production.up.railway.app
Swap URL:           https://skew-production.up.railway.app/trade
Chain:              Base (chain id 8453)
Factory address:    <TBD — populated post-deploy>
$HELIX token:       <TBD — populated post-deploy>
v4 Hook:            <TBD — populated post-deploy>
Margin asset:       USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48)
Logo (PNG):         https://skew-production.up.railway.app/brand/helix-mark-512.png
Logo (SVG):         https://skew-production.up.railway.app/brand/helix-mark.svg
Description:        Hook-native perp DEX on Base mainnet. Mark price is the live pool
                    price — no off-chain oracle, no admin, no upgrade key. 24 markets,
                    25× max leverage on majors, cross-margined USDC. HLP backstop earns
                    50% of all fees; $HELIX captures the other 50% via buyback-and-burn.
Audit:              In progress · public report linked from /docs#audits on completion
Open source:        Yes · MIT-licensed contracts at contract/src/HelixPerps.sol
Twitter / X:        <TBD>
Discord:            <TBD>
Telegram:           <TBD>
Contact:            team@helix.trade
Daily volume est.:  <TBD — populated post-deploy from /api/stats>
```

---

## Coverage matrix · which aggregators

| Aggregator | Form / how to submit | Logo size needed | Daily vol gate |
| --- | --- | --- | --- |
| DexScreener | forum thread w/ fields above | 128×128 PNG | — |
| Dextools | their listing portal | 128×128 PNG | $50k/day prio |
| Birdeye | partner form | 256×256 PNG | — |
| GeckoTerminal | self-serve via subgraph | 200×200 PNG | $5k TVL |
| CoinGecko | full token application | 200×200 PNG | post-listing |
| CoinMarketCap | full token application | 200×200 PNG | post-listing |
| DefiLlama | open PR with adapter | 64×64 PNG | — |

All required sizes are present in `brand/`. The lockup variants are for partner pages, press kits, and Twitter banner crops.

---

_Last updated 2026-05-15 · build `skew/0.7`_
