Skip to content

Try the API

Tracker (public)

Terminal window
TRACKER=https://tracker.stonkagents.com
# Is it up?
curl "$TRACKER/health"
# The launch parameters the form uses: fee, the $STONK quote, the raise, the curve
curl "$TRACKER/api/launch/config"
# Every launch on the network, newest first
curl "$TRACKER/api/launches?limit=10&offset=0"
# One launch, with live metrics
curl "$TRACKER/api/launch/<mint>"
# Its newest trades and 1h candles
curl "$TRACKER/api/launch/<mint>/trades?limit=20"
curl "$TRACKER/api/launch/<mint>/candles?interval=1h&limit=100"
# Every launch by a wallet (one per wallet)
curl "$TRACKER/api/launch/by-wallet?wallet=<wallet>"
# Network stats and leaderboards
curl "$TRACKER/api/v1/tracker/stats"
curl "$TRACKER/api/v1/tracker/leaderboard/seeders?limit=5"

Asking for any quote but $STONK is refused:

Terminal window
curl "$TRACKER/api/launch/config?quoteMint=So11111111111111111111111111111111111111112"
# 422 {"error":{"code":"QUOTE_NOT_ALLOWED","message":"only the $STONK quote is launchable on this platform"}}

Where the fees went

Terminal window
# Platform-wide: totals by kind, a daily series, the newest entries, the wallets
curl "$TRACKER/api/revenue"
# The same ledger for one token
curl "$TRACKER/api/revenue?mint=<mint>&limit=50"
# What one wallet has been paid from the holder tax
curl "$TRACKER/api/revenue/holder/<wallet>"

Every entry carries the on-chain signature and an explorer link, so nothing the tracker reports has to be taken on trust. See The holder tax.

Your agent (local)

Terminal window
AGENT=http://localhost:7841
# Is it up, and what version?
curl "$AGENT/health"
# Status, including your Agent ID
curl "$AGENT/api/v1/status"
# The setup checks the Permissions step renders
curl "$AGENT/api/v1/setup/status"
# Did the background command-tools install finish?
curl "$AGENT/api/v1/controller/setup/command-tools"
# Apply a fix (the header is required)
curl -X POST "$AGENT/api/v1/setup/bandwidth" \
-H "Content-Type: application/json" -H "X-StonkAgents-Setup: 1" -d '{}'
# Your transfers and library
curl "$AGENT/api/v1/downloads/status"
curl "$AGENT/api/v1/library"
# Update status from the controller, through the agent
curl "$AGENT/api/v1/controller/update/status"

Chat completions with your key

The stonkagents tools talk to the tracker as an OpenAI-style endpoint with the key the installer fetched from your agent. You can do the same:

Terminal window
KEY=$(curl -s http://127.0.0.1:7841/api/v1/installer/peer-key | jq -r .api_key)
curl "$TRACKER/api/v1/agents/chat/completions" \
-H "X-API-Key: $KEY" -H "Content-Type: application/json" \
-d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"hello"}]}'

Each call is metered in credits like a chat message in the portal: gpt-5.4-mini is Fast, gpt-5.4 is Detailed.