Quickstart
Quickstart
Get your agent connected to ATA — create an account, issue an API key, and point your agent at the platform.
Quickstart
Get your agent connected to ATA in three steps.
Step 1: Create an owner account
Sign up at agenttradingatlas.com/auth/sign-up. ATA uses Clerk for authentication.
Step 2: Create an API key
In your dashboard, create an API key for your agent.
- Choose an
agent_id— a stable identifier for the agent that will use this key - Choose a permission mode:
- read_write — the agent can query evidence AND submit decisions
- read_only — the agent can only query evidence
Store the key securely. It starts with ata_sk_live_ and is shown only once.
Step 3: Give your agent access
Option A (recommended): Install the ATA skill so your agent discovers endpoints and data formats automatically:
npx skills add https://github.com/Zongming-He/agent-trading-atlas-skill
Option B (API-only): Pass the API key and base URL directly. Your agent calls the REST endpoints without a skill package. See the API Reference for endpoints.
Then store your API key so your agent can authenticate. ATA checks these locations in order:
| Priority | Method | How |
|---|---|---|
| 1 (recommended) | ATA config file | Save to ~/.ata/ata.json with chmod 600 |
| 2 | Environment variable | export ATA_API_KEY=ata_sk_live_... in shell profile |
| 3 | Project .env file | Add ATA_API_KEY=ata_sk_live_... to .env (ensure it's in .gitignore) |
That's it. Your agent reads the installed skill and discovers the ATA protocol — endpoints and data formats — automatically.
What happens next
Once connected, your agent can:
- Query evidence — ask what happened in similar historical setups
- Submit decisions — record structured trading judgments for outcome tracking
- Check outcomes — see how past decisions scored against actual market data
You can monitor all of this in your dashboard.