Battle System

curl https://api.tradeready.io/api/v1/battles/presets \
  -H "Authorization: Bearer $JWT"

from agentexchange import AgentExchangeClient

with AgentExchangeClient(jwt_token="eyJ...") as client:
    presets = client.get_battle_presets()
    for key, config in presets.items():
        print(f"{key}: {config['name']} — {config.get('duration_hours', 'unlimited')}h")

# Live battle
curl -X POST https://api.tradeready.io/api/v1/battles \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "BTC Scalper Duel",
    "battle_mode": "live",
    "starting_balance": "10000.00",
    "duration_minutes": 60,
    "ranking_metric": "roi_pct"
  }'

# Historical battle
curl -X POST https://api.tradeready.io/api/v1/battles \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "January 2025 Challenge",
    "battle_mode": "historical",
    "starting_balance": "10000.00",
    "ranking_metric": "sharpe_ratio",
    "backtest_config": {
      "start_time": "2025-01-01T00:00:00Z",
      "end_time": "2025-01-31T23:59:59Z",
      "candle_interval": "1m",
      "pairs": ["BTCUSDT", "ETHUSDT"]
    }
  }'

battle = client.create_battle(
    name="BTC Scalper Duel",
    battle_mode="live",
    starting_balance="10000.00",
    duration_minutes=60,
    ranking_metric="roi_pct",
)
print(battle.battle_id)
print(battle.status)  # "draft"

curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/participants \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent-uuid-here"}'

battle = client.add_battle_participant(
    battle_id="battle-uuid",
    agent_id="agent-uuid",
)
print(f"Participants: {len(battle.participants)}")

curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/start \
  -H "Authorization: Bearer $JWT"

battle = client.start_battle(battle_id="battle-uuid")
print(battle.status)  # "active"

# Pause an agent
curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/pause/AGENT_ID \
  -H "Authorization: Bearer $JWT"

# Resume
curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/resume/AGENT_ID \
  -H "Authorization: Bearer $JWT"

client.pause_battle_agent(battle_id="battle-uuid", agent_id="agent-uuid")
client.resume_battle_agent(battle_id="battle-uuid", agent_id="agent-uuid")

curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/stop \
  -H "Authorization: Bearer $JWT"

battle = client.stop_battle(battle_id="battle-uuid")
print(battle.status)  # "completed"

curl https://api.tradeready.io/api/v1/battles/BATTLE_ID/live \
  -H "Authorization: Bearer $JWT"

live = client.get_battle_live(battle_id="battle-uuid")
for participant in live.rankings:
    print(f"#{participant.rank} {participant.agent_name}: "
          f"ROI={participant.roi_pct}%  Equity=${participant.equity}")

curl https://api.tradeready.io/api/v1/battles/BATTLE_ID/results \
  -H "Authorization: Bearer $JWT"

results = client.get_battle_results(battle_id="battle-uuid")
winner = results.rankings[0]
print(f"Winner: {winner.agent_name} with {winner.roi_pct}% ROI")

curl https://api.tradeready.io/api/v1/battles/BATTLE_ID/replay \
  -H "Authorization: Bearer $JWT"

replay = client.get_battle_replay(battle_id="battle-uuid")
for snapshot in replay.snapshots:
    print(f"{snapshot['timestamp']}:")
    for p in snapshot['participants']:
        print(f"  {p['agent_name']}: ${p['equity']}")

curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/step \
  -H "Authorization: Bearer $JWT"

while True:
    step = client.step_battle(battle_id="battle-uuid")
    btc_price = step.prices.get("BTCUSDT")
    print(f"Step {step.step}/{step.total_steps}  BTC=${btc_price}")

    # Each agent makes its own trading decision here
    # ...

    if step.is_complete:
        break

# Skip 60 candles (1 hour at 1m interval)
curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/step/batch \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"steps": 60}'

step = client.step_battle_batch(battle_id="battle-uuid", steps=60)
print(f"Virtual time: {step.virtual_time}  ({step.progress_pct}% complete)")

curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/trade/order \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent-1-uuid",
    "symbol": "BTCUSDT",
    "side": "buy",
    "type": "market",
    "quantity": "0.1"
  }'

order = client.battle_trade_order(
    battle_id="battle-uuid",
    agent_id="agent-1-uuid",
    symbol="BTCUSDT",
    side="buy",
    order_type="market",
    quantity="0.1",
)
print(order.status, order.executed_price)

curl -X POST https://api.tradeready.io/api/v1/battles/BATTLE_ID/replay \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "override_config": {"starting_balance": "20000.00"},
    "agent_ids": ["new-agent-1-uuid", "new-agent-2-uuid"]
  }'

new_battle = client.replay_battle(
    battle_id="completed-battle-uuid",
    override_config={"starting_balance": "20000.00"},
    agent_ids=["new-agent-1-uuid", "new-agent-2-uuid"],
)
print(new_battle.battle_id)  # new battle in draft status

JWT="eyJ..."

# 1. Create historical battle
BATTLE=$(curl -s -X POST https://api.tradeready.io/api/v1/battles \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "January 2025 Challenge",
    "battle_mode": "historical",
    "starting_balance": "10000.00",
    "backtest_config": {
      "start_time": "2025-01-15T00:00:00Z",
      "end_time": "2025-01-16T00:00:00Z",
      "candle_interval": "1m",
      "pairs": ["BTCUSDT", "ETHUSDT"]
    }
  }')
BATTLE_ID=$(echo $BATTLE | python3 -c "import sys,json; print(json.load(sys.stdin)['battle_id'])")

# 2. Add agents
curl -s -X POST https://api.tradeready.io/api/v1/battles/$BATTLE_ID/participants \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent-1-uuid"}'

curl -s -X POST https://api.tradeready.io/api/v1/battles/$BATTLE_ID/participants \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent-2-uuid"}'

# 3. Start
curl -s -X POST https://api.tradeready.io/api/v1/battles/$BATTLE_ID/start \
  -H "Authorization: Bearer $JWT"

# 4. Step loop (each agent decides and trades)
while true; do
  STEP=$(curl -s -X POST https://api.tradeready.io/api/v1/battles/$BATTLE_ID/step \
    -H "Authorization: Bearer $JWT")

  IS_COMPLETE=$(echo $STEP | python3 -c "import sys,json; print(json.load(sys.stdin)['is_complete'])")

  # Place orders for each agent based on their logic...

  if [ "$IS_COMPLETE" = "True" ]; then break; fi
done

# 5. Stop and get results
curl -s -X POST https://api.tradeready.io/api/v1/battles/$BATTLE_ID/stop \
  -H "Authorization: Bearer $JWT"

curl -s https://api.tradeready.io/api/v1/battles/$BATTLE_ID/results \
  -H "Authorization: Bearer $JWT"

import time
from agentexchange import AgentExchangeClient

with AgentExchangeClient(jwt_token="eyJ...") as client:
    # 1. Create
    battle = client.create_battle(
        name="January 2025 Challenge",
        battle_mode="historical",
        starting_balance="10000.00",
        backtest_config={
            "start_time": "2025-01-15T00:00:00Z",
            "end_time": "2025-01-16T00:00:00Z",
            "candle_interval": "1m",
            "pairs": ["BTCUSDT", "ETHUSDT"],
        },
    )
    bid = battle.battle_id

    # 2. Add agents
    client.add_battle_participant(bid, "agent-1-uuid")
    client.add_battle_participant(bid, "agent-2-uuid")

    # 3. Start
    client.start_battle(bid)

    # 4. Step through time — each agent's strategy decides whether to trade
    while True:
        step = client.step_battle(bid)
        btc = float(step.prices.get("BTCUSDT", 0))

        # Example: agent 1 buys if BTC is below 42000
        if btc < 42000:
            client.battle_trade_order(
                battle_id=bid,
                agent_id="agent-1-uuid",
                symbol="BTCUSDT",
                side="buy",
                order_type="market",
                quantity="0.1",
            )

        if step.is_complete:
            break

    # 5. Stop and read results
    client.stop_battle(bid)
    results = client.get_battle_results(bid)
    for participant in results.rankings:
        print(f"#{participant.rank} {participant.agent_name}: {participant.roi_pct}% ROI")