Overview
Meridian is a complete platform for running a proprietary trading firm, and you get the full source code. A trader buys a challenge (or claims a free trial), trades it in a browser terminal against live crypto prices, and the platform checks the account's rules on every price change: daily loss, maximum loss, profit target and minimum trading days. A trader who passes moves to a verification stage, completes KYC, and receives a funded account. From there they can request payouts, which your staff approve and release.
Orders are never sent to an exchange. A deterministic execution engine written in Go fills them against the live price feed, and a separate risk service records every breach with the exact price that caused it. Around that core sit a NestJS API with a double-entry ledger, a Next.js web app with a public marketing site, a trader workspace and a staff admin console, plus Docker Compose files for local development and single-server production.
Features
Trading terminal
- Price chart: Candlestick chart with 1m, 5m, 15m, 1h, 4h and 1d intervals, bid, ask, spread and 24-hour high and low.
- Order ticket: Market, limit and stop orders with optional stop loss and take profit, a quantity helper based on free margin, and a warning when a stop sits past the account's breach level.
- Positions and orders: Open positions with live unrealised P&L, edit SL and TP, close one, close all, close winners or close losers. Tabs for working orders, history and the account log.
- Headroom strip: Equity, balance, daily loss used, maximum loss used, profit target progress, trading days and a countdown to the daily reset, updated in real time over WebSocket.
Trader workspace
- Account overview: Balance, equity, floating P&L, trading days and a card per rule showing the limit and how much is used.
- Goals and rules pages: Distance to each limit, the daily floor and how it is anchored, and the full ruleset the account was sold under.
- Orders page: Every order with fill price, status and realised P&L.
- Payouts page: Eligibility checks, payout methods (crypto address or bank details), requests and history.
- Settings: Password change, authenticator-app two-factor sign-in, signed-in sessions, and an affiliate page for traders who join the programme.
Challenges and accounts
- Two-stage evaluation: A challenge stage and a verification stage, then a funded account. The seed catalogue has $10,000, $25,000 and $50,000 sizes at $99, $199 and $349, with a 10% / 5% profit target, 5% daily loss and 10% static maximum loss.
- Rules as data: Rulesets are versioned database rows, not code. The risk service supports static or trailing maximum loss, daily loss with a configurable reset time zone, profit target, minimum trading days and an optional consistency rule.
- Free trial: One simulated trial per email address (14 days by default) on the smallest challenge's rules, with no fee, no payout and no ledger entries. A scheduler closes it when it ends.
- Instruments: Ten crypto pairs out of the box (BTC, ETH, SOL, XRP, BNB, ADA, DOGE, AVAX, LINK and LTC against USD), with per-symbol spread, commission, leverage and financing.
Execution engine and risk (Go)
- Market data service: Live WebSocket feeds from Binance and Coinbase, candle building, a stale-feed watchdog that halts trading, and an archive of ticks to S3-compatible storage as Parquet.
- Execution engine: Order lifecycle, slippage, margin, daily financing and stop-out, with integer money maths (no floats) and Redis snapshots for fast restarts.
- Risk evaluator: Warnings and breaches on every tick, daily resets, and breach records that name the triggering price.
- Replay and goldens: A replay tool for recorded market days and 84 engine plus 52 risk golden scenarios that must reproduce exactly.
- WebSocket gateway: Pushes prices, fills and account figures to the browser using short-lived tickets.
Payments, ledger and payouts
- Checkout: Stripe Checkout (hosted page, signed webhooks), plus PayPal and CoinGate adapters and a mock processor for development. Unmatched or unexpected payments go to a manual review queue instead of guessing.
- Double-entry ledger: Every fee, refund and payout posts balanced entries, with reconciliation checks.
- Payouts: Profit split and payout period from the ruleset, challenge fee refunded with the first payout, one approver below a threshold and two distinct approvers above it, and a separate release step. Every staff action is written to an audit log.
- Affiliate programme: Applications, referral attribution, commission accrual with a hold period, commission payouts and void requests, managed from the admin console.
KYC
- Document upload: Identity, address, agreement and payout-method documents, encrypted at rest with rotatable keys and stored in S3-compatible storage.
- Review queue: Staff claim, approve, or ask for more information. Clearing KYC creates the funded account. Old documents are purged on a retention schedule.
Public site and admin console
- Marketing site: Home, challenges and pricing, how it works, trading rules, instruments, platform, payouts, affiliates, FAQ, about, contact, blog and a status page with uptime history and incidents.
- Sign-up: Email one-time code, account lockout and rate limits, password reset, and the same response for new and existing addresses so accounts cannot be enumerated.
- Admin console: KYC and payout queues, users and accounts with search, site settings, contact inbox, newsletter subscribers (double opt-in), blog editor with images, legal document editor, status incidents and affiliate management, with role-based capabilities.
- Emails: Branded transactional emails (sign-up code, set password, password reset, account ready) sent over any SMTP provider.
Good to know
- Running a prop firm is regulated differently by country. You are responsible for the legal, tax and regulatory side, including your terms, risk disclosures, KYC/AML duties and payment-provider approval. The legal pages in the code are drafts.
- The default payment processor is a mock. The Stripe adapter runs in Stripe test mode on the reference deployment. The PayPal and CoinGate adapters are built against the vendors' published APIs and unit-tested, but have not been run against their sandboxes.
- Payout release is manual: staff send the money by crypto or bank transfer outside the platform and record it. KYC is reviewed by your staff; there is no automated ID-verification vendor.
- Forex and metals support (Twelve Data and TraderMade adapters, trading sessions, calendars) is built but switched off by default.
- The public leaderboard page is a placeholder, and the admin overview's charts show sample figures. Certificates are not built.
- The reference deployment is a single server. Off-host backups and alerting are left to you.
- The repository includes the full engineering record (spec, design system, phase reports, escalations and runbooks), which is long and written for the original team.
Tech stack
- Next.js 16 (App Router), React 19, TypeScript, TanStack Query, TradingView Lightweight Charts
- NestJS 11 API with PostgreSQL 16, BullMQ on Redis 7, KafkaJS
- Go 1.22 services: market data, execution engine, risk, WebSocket gateway
- Redpanda (Kafka API) as the event backbone, Redis for snapshots
- MinIO or any S3-compatible storage for KYC documents, blog images and tick archives
- pnpm workspaces, Turborepo, Go workspaces, Jest, Go tests, Docker Compose
What's included
- Monorepo:
apps/web, services/api, services/engine, services/risk, services/market-data, services/ws-gateway, and the shared packages/ui and packages/schema
- 109 database migrations and seeds for the launch catalogue, rulesets and symbols
docker-compose.yml for local development and infra/coolify/docker-compose.yml for a single-server production stack, with Dockerfiles and operating notes
- Terraform modules for AWS (network, compute, data, edge, ops); these are not used by the reference deployment
- Unit, end-to-end and latency tests, golden scenarios, recorded market data for replay, and a
Makefile that runs them
- Technical spec, design system, HTML design mockups, runbooks and phase reports
.env.local.example documenting every setting
Requirements and third-party costs
You need Node 20.11+, pnpm 9, Go 1.22+ and Docker. The stack runs PostgreSQL, Redis, Redpanda and MinIO in containers, so one server with enough memory for about a dozen containers can run everything. The Coolify compose file in the repository is what the reference deployment uses.
- Hosting (required): A VPS or any Docker host. All databases and storage can be self-hosted in the provided containers.
- Crypto market data (required, free): Binance and Coinbase public WebSocket feeds. No account or key is needed.
- Forex and metals data (optional): Twelve Data or TraderMade, paid plans, only if you turn on FX and metals.
- Payment processor (required to take real money): Stripe by default; PayPal and CoinGate are optional alternatives. Each needs a merchant account approved for prop-trading products, which many processors restrict.
- Email (required): Any SMTP service, such as Resend. Sign-up depends on emailed codes.
- S3 storage (optional): MinIO is included; AWS S3 or another provider can replace it.
- KYC: No third-party fee; documents are reviewed by your own staff.
- Payout rails: Fees from your bank or crypto wallet when you send payouts.
The purchase covers the source code only. Service fees are billed by the providers listed above.