Skip to main content
Setting up ParlayX means building the structure your trading runs inside: at least one pod, funded, connected to the venues you trade, with at least one actor permitted to trade it. It takes a few minutes. This page is the path end to end.
Read Core Concepts first if you have not. Everything below assumes you know what a pod and an actor are, and the setup makes considerably more sense with that in hand.

1. Create a pod

A pod is a segregated book of capital. Everything else attaches to one. Create your first pod in the console and name it after whatever it represents — a strategy, a desk, a client book. Its wallet is provisioned automatically and belongs to the pod permanently. If you are not sure how to divide things up, start with one pod. Adding more later is straightforward; splitting a book that has been trading is not.

Pods

How to think about pod structure, and what belongs to a pod.

2. Fund it

Each pod has its own deposit address. Send USDC to the address shown on the pod’s detail page and the balance credits to that pod. There is no organization-level balance that you then divide. Capital arrives at a pod and belongs to it.
Deposit addresses are per pod. Check the address against the pod name before sending.
Kalshi works differently — you fund your Kalshi account directly at Kalshi, because our credentials there are trading-only and cannot move money. See Deposit.

3. Connect your venues

On-chain venues need nothing: the pod’s wallet is already in place, and funds are bridged to venue deposit addresses automatically. For Kalshi, an administrator connects your organization’s Kalshi account once, and pods trade through it. The account is KYC’d to your entity, so it is yours to supply.

Venues

How each venue connects, and what separation between pods looks like.

4. Whitelist a withdrawal address

Do this now rather than when you need it. Funds can only be withdrawn to an address whitelisted in advance, and whitelists are maintained per pod. Adding the destination at setup means a withdrawal later is one step instead of two.

5. Add actors

An actor is a trading identity — a person or a bot. Add one to the pod and issue it a key. Keys are Ed25519 keypairs generated in your environment. You register the public key; the private key never leaves your systems. Each key is bound to one actor and one pod, and that binding is fixed. If you are trading through the console rather than the API, you still need an actor, because every order is attributed to one.

Actors and permissions

What an actor can do, and how to withdraw access.

6. Check the pod is ready

The pod’s readiness strip shows four states. All four must be green before it can trade. A pod that is not venue-ready rejects orders rather than routing them somewhere unintended.

7. Trade

Through the console, or through the API. If you are integrating programmatically, start by calling whoami. It is the smallest signed request you can make, and a successful response confirms your signing implementation works before you build anything on top of it.

Authentication

How to sign a request, and what gets checked.

API Reference

Endpoints, parameters, responses.

Then

Portfolio and positions

Orders, fills, exposure, and P&L across every pod.

Market mapping

The same outcome, aligned across every venue that lists it.

Move funds between pods

Reallocating capital as strategies change between pods

Common questions

What we get asked most by funds and desks.
Anything not covered — contact@parlayx.com.