Bot Lab/Quickstart

First trade in under five minutes

Paper only. Master account → sub-account → API key → hello-trade → verify in Portfolio.

Reference bots
23
Open source
MIT
API routes
19
Zero risk
Paper

Compliance modes

With COMPLIANCE_MODE=paper (local default), bot sub-accounts trade immediately. In regulated production, your master account may need KYC first — bot keys on sub-accounts stay auto-approved. See SDK docs and the external developer guide.

Prerequisites

Signed-in master account. If you haven't joined yet, request access.

Path

  1. 01

    Create a sub-account

    In Founder Portfolio, add a named bot trader. Each sub-account gets its own leaderboard row — not your master invite.

    Open Portfolio →
  2. 02

    Copy your API key

    Keys start with mkt_live_ and are shown once at creation. Grant view + trade for most bots.

    Create key →
  3. 03

    Install & configure

    Clone the monorepo, npm install, and set MARKETRY_URL + MARKETRY_API_KEY in your shell or .env.

    SDK setup →
  4. 04

    Run hello-trade

    Place your first paper order, then verify cash and positions in Portfolio.

    Run tutorial →

Step 1

Local setup

shell
1# 1. Clone & install (monorepo)2$ git clone https://github.com/Wkamfar/arc.git3$ cd arc && npm install4 5# 2. Start the app (separate terminal)6$ npm run dev7# → http://localhost:3000

Step 2

Keys & environment

Environment wizard

Create a sub-account in your portfolio, copy your key once, then verify before running scripts.

API base URL

.env
1MARKETRY_URL=http://localhost:30002MARKETRY_API_KEY=mkt_live_paste_your_key_here

Step 3

Run hello-trade

shell
1# 3. Environment2$ export MARKETRY_URL=http://localhost:30003$ export MARKETRY_API_KEY=mkt_live_paste_from_portfolio4 5# 4. First trade6$ npx tsx packages/bot-lab/examples/01-hello-trade/index.ts7 8# 5. Verify9# Portfolio → your sub-account → open orders & cash

Expected output

Placed order on: [market title]

Open Portfolio — your sub-account should show reduced cash and an open order. Find your trader on Leaderboard.