Documentation

How win-trader works, end to end: the Vault and your margin, oracle prices, liquidation, the fees, copy trading, and the public API.

Getting Started

Welcome to win-trader — A perpetual futures exchange on Stellar. The pool is the counterparty and your wallet signs every trade.
Log on and get funded — Log on with an email, a Google account or a Stellar wallet, then claim test USDC from the Faucet.
Your first trade — From an empty ticket to an open position and back, with every number on the way explained.

The Vault and your margin — One pool underwrites every trade. Your collateral is what backs yours.
Positions — What a position is made of, and what each field in the row means.
Profit, loss and fees — Where every number in the position row comes from.
Liquidation — What it is, exactly when it happens, and how to keep it from happening.
Oracle prices — Two price feeds do two different jobs, and only one of them settles money.

Deposit and withdraw — Getting funds into your wallet, into the pool, and back out again.
Opening and closing — Sizing, slippage, max size, and partial closes.
Take profit and stop loss — Triggers that close a position for you, what they cost, and what they read.
Your name and profile — Portfolio, the public page other traders see, what a name change costs, and Telegram alerts.
Copy Trading — Follow a trader or a setup. It suggests and sizes; you still sign.
Backtrack — The chart, rewound. Practise on history with paper money.

How settlement works — Contracts, oracle, keeper and indexer: the four pieces, and which one owns your money.
The competition and the leaderboard — What the strip on top is telling you, and how the board ranks people.

API overview — One base URL, plain JSON, public reads with no key at all.
Markets and prices — The instruments, the oracle marks, the candles and the protocol config.
Traders and positions — Positions, the trade tape, the leaderboard, and the public bits of a profile.
Vault — The pool's state, its history, and one depositor's share of it.
Authentication — Sign one message for a 30-day session token, or sign each request, depending on the route.

FAQ — The questions that come up first, answered shortest.
Glossary — Every term this app uses without stopping to explain it.
Where to find us — Discord, X and Telegram, plus how to report something that looks wrong.

About win-trader — What win-trader is, what it is built on, what stage it is at, and what it deliberately cannot do.
Risk disclosure — Leverage, liquidation, the oracle, the contracts and the pool: what can go wrong here, and the mechanism that does it.
Terms of use — The terms this interface is offered under: no custody, no advice, no warranty, and the contracts as the record.