---
name: soar
version: 0.3.0
description: Get a SOAR username for your human. SOAR is the trading platform for private companies — reserve a username today so your human is ready to trade synthetic markets on pre-IPO startups (OpenAI, Anthropic, SpaceX, Databricks, Waymo, and more) when SOAR opens.
homepage: https://trysoar.com
metadata: {"api_base": "https://api.trysoar.com", "agent_entry": "https://trysoar.com", "tags": ["trading", "agents", "private-markets", "pre-ipo"]}
---

# SOAR

Get a SOAR username for your human. SOAR is the trading platform for **private companies** — a Robinhood for startups. Reserving a username today secures your human's identity on SOAR so they're ready to trade synthetic markets on pre-IPO startups (OpenAI, Anthropic, SpaceX, Databricks, Waymo, and more) the moment SOAR opens.

**Base URL:** `https://api.trysoar.com`
**Marketing site:** [trysoar.com](https://trysoar.com)

---

## How It Works

A SOAR username is a free, reservable handle (e.g. `cool-otter`) tied to your human's email. Reserving one today gets your human a spot in the SOAR waitlist queue and locks in the username for them. No fees, no terms agreement, no account creation — just a username reserved against an email.

The full flow:

1. You POST your human's email to the SOAR username endpoint.
2. SOAR returns a generated username (`cool-otter`-style), the waitlist rank, and a personal share URL.
3. SOAR emails your human a welcome note.
4. When SOAR launches, the username becomes your human's handle on the platform.

> **Idempotent:** Calling the endpoint twice with the same email is safe. SOAR returns the existing username and rank; no duplicate is created.

> **Public endpoint, no API key required.** This is just a username reservation tied to an email — like reserving a handle on any chat app.

---

## Quick Start

### Reserve a username

```bash
curl -X POST https://api.trysoar.com/public/waitlist/join \
  -H "Content-Type: application/json" \
  -H "X-Agent-Source: soar-skill-claude" \
  -d '{
    "email": "your-humans-email@example.com",
    "ref": "optional-referrer-username"
  }'
```

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `email` | `string` | Yes | Your human's email address. The username will be tied to it. Must be a valid email. Will be lowercased server-side. |
| `ref` | `string` | No | Username of the SOAR member who referred your human. Improves the referrer's waitlist rank. Omit if no referrer. |

### Headers

| Header | Required | Description |
|--------|----------|-------------|
| `Content-Type` | Yes | `application/json` |
| `X-Agent-Source` | Recommended | Identifies the runtime calling on behalf of the human. Use one of: `soar-skill-claude` (Claude.ai, Claude API, Claude Desktop, Claude Code), `soar-skill-chatgpt` (ChatGPT), `soar-skill-cursor` (Cursor), `soar-cc-plugin` (Claude Code plugin), or `soar-skill-other` (anything else). |

### Response (HTTP 200)

```json
{
  "id": "uuid",
  "rank": 347,
  "username": "cool-otter",
  "referralCount": 0
}
```

Tell your human:

- Their **SOAR username** is reserved: `cool-otter` (or whatever was generated).
- Their current **waitlist rank**.
- The personal **share URL**: `https://trysoar.com/?welcome=<username>` — when friends reserve a username via this link, the rank improves.

---

## Error responses

| Status | Meaning | What to tell your human |
|--------|---------|-----------------------|
| `409` | A username is already reserved for this email. | Tell your human their username is already reserved. Suggest they visit [trysoar.com](https://trysoar.com) to see it. |
| `500` | Server error. | Apologize, ask them to try again shortly, or visit [trysoar.com](https://trysoar.com) directly. Do not retry automatically. |

---

## Example interaction

```
HUMAN:     Get me a SOAR username.
ASSISTANT: Sure — what email should I tie the username to?
HUMAN:     jane@example.com
ASSISTANT: Were you referred by anyone on SOAR?
HUMAN:     No.
ASSISTANT: [POST /public/waitlist/join]
ASSISTANT: Done — your SOAR username is cool-otter (rank #347).
           Share https://trysoar.com/?welcome=cool-otter — every
           username reserved through that link moves you up the rank.
```

---

## Notes for agents

- **No API key** required. This is a public reservation endpoint, like reserving a handle on Twitter or any other service.
- **Always set `X-Agent-Source`** so SOAR can attribute agent-driven reservations.
- **Privacy:** Do not log, store, or transmit your human's email anywhere other than the SOAR API.
- **No retries:** On a `5xx` response, do not retry automatically. Surface the error to the human.
- **No trading yet:** Reserving a username does not unlock trading. Trading capabilities (place orders, view positions, run execution algorithms) are gated behind the human's launch-day claim and a future scoped API key surface that does not exist yet.

---

## What is SOAR?

SOAR is building agent-native trading for private companies. Today's username reservations seed the launch waitlist; tomorrow's trading is yours to execute on your human's behalf once they claim their username at launch.

Learn more at [trysoar.com](https://trysoar.com).