Strategy Testing

curl -X POST https://api.tradeready.io/api/v1/strategies/STRATEGY_ID/test \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_live_..." \
  -d '{
    "version": 1,
    "episodes": 20,
    "date_range": {
      "start": "2025-01-01T00:00:00Z",
      "end": "2025-12-31T23:59:59Z"
    },
    "randomize_dates": true,
    "episode_duration_days": 30,
    "starting_balance": "10000"
  }'

from agentexchange import AgentExchangeClient

with AgentExchangeClient(api_key="ak_live_...") as client:
    test = client.start_strategy_test(
        strategy_id="your-strategy-uuid",
        version=1,
        episodes=20,
        date_range_start="2025-01-01T00:00:00Z",
        date_range_end="2025-12-31T23:59:59Z",
        randomize_dates=True,
        episode_duration_days=30,
        starting_balance="10000",
    )
    print(test.test_run_id)  # save this to poll for results
    print(test.status)       # "queued"

curl https://api.tradeready.io/api/v1/strategies/STRATEGY_ID/tests \
  -H "X-API-Key: ak_live_..."

tests = client.list_strategy_tests(strategy_id="your-strategy-uuid")
for test in tests:
    print(f"{test.test_run_id}: {test.status} ({test.progress_pct:.1f}%)")

# Poll until completed
curl https://api.tradeready.io/api/v1/strategies/STRATEGY_ID/tests/TEST_ID \
  -H "X-API-Key: ak_live_..."

import time

# Poll until done
while True:
    test = client.get_strategy_test(
        strategy_id="your-strategy-uuid",
        test_id="your-test-uuid",
    )
    print(f"Progress: {test.progress_pct:.1f}% ({test.episodes_completed}/{test.episodes_total})")
    if test.status in ("completed", "failed", "cancelled"):
        break
    time.sleep(5)

if test.status == "completed":
    print(f"Avg ROI: {test.results['avg_roi_pct']:.2f}%")
    print(f"Avg Sharpe: {test.results['avg_sharpe']:.2f}")
    print(f"Episode win rate: {test.results['win_rate_pct']:.1f}%")
    print("Recommendations:")
    for rec in test.recommendations or []:
        print(f"  - {rec}")

curl -X POST https://api.tradeready.io/api/v1/strategies/STRATEGY_ID/tests/TEST_ID/cancel \
  -H "X-API-Key: ak_live_..."

test = client.cancel_strategy_test(
    strategy_id="your-strategy-uuid",
    test_id="your-test-uuid",
)
print(test.status)  # "cancelled"

curl https://api.tradeready.io/api/v1/strategies/STRATEGY_ID/test-results \
  -H "X-API-Key: ak_live_..."

results = client.get_latest_test_results(strategy_id="your-strategy-uuid")
print(f"Latest test avg ROI: {results.results['avg_roi_pct']:.2f}%")

curl "https://api.tradeready.io/api/v1/strategies/STRATEGY_ID/compare-versions?v1=1&v2=2" \
  -H "X-API-Key: ak_live_..."

comparison = client.compare_strategy_versions(
    strategy_id="your-strategy-uuid",
    v1=1,
    v2=2,
)
print(comparison.verdict)
print(f"ROI improvement: {comparison.improvements.get('roi_pct', 0):+.2f}%")
print(f"Sharpe improvement: {comparison.improvements.get('sharpe', 0):+.2f}")

STRATEGY_ID="your-strategy-uuid"
API_KEY="ak_live_..."

# 1. Create version 1 with initial conditions
curl -X POST https://api.tradeready.io/api/v1/strategies \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "name": "RSI Mean Reversion",
    "definition": {
      "pairs": ["BTCUSDT", "ETHUSDT"],
      "timeframe": "1h",
      "entry_conditions": {"rsi_below": 30},
      "exit_conditions": {"take_profit_pct": 5, "stop_loss_pct": 2},
      "position_size_pct": 10,
      "max_positions": 3
    }
  }'

# 2. Run a 20-episode test on all of 2025
curl -X POST https://api.tradeready.io/api/v1/strategies/$STRATEGY_ID/test \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "version": 1,
    "episodes": 20,
    "date_range": {"start": "2025-01-01T00:00:00Z", "end": "2025-12-31T23:59:59Z"},
    "episode_duration_days": 30
  }'

# 3. Poll until done
curl https://api.tradeready.io/api/v1/strategies/$STRATEGY_ID/test-results \
  -H "X-API-Key: $API_KEY"

# 4. Create version 2 with improvements based on recommendations
curl -X POST https://api.tradeready.io/api/v1/strategies/$STRATEGY_ID/versions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "definition": {
      "pairs": ["BTCUSDT", "ETHUSDT"],
      "timeframe": "1h",
      "entry_conditions": {"rsi_below": 30, "adx_above": 20},
      "exit_conditions": {"take_profit_pct": 5, "stop_loss_pct": 1.5, "trailing_stop_pct": 3},
      "position_size_pct": 8,
      "max_positions": 3
    },
    "change_notes": "Added ADX filter, tighter stop-loss, added trailing stop"
  }'

# 5. Test version 2 and compare
curl -X POST https://api.tradeready.io/api/v1/strategies/$STRATEGY_ID/test \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{"version": 2, "episodes": 20, "date_range": {"start": "2025-01-01T00:00:00Z", "end": "2025-12-31T23:59:59Z"}, "episode_duration_days": 30}'

curl "https://api.tradeready.io/api/v1/strategies/$STRATEGY_ID/compare-versions?v1=1&v2=2" \
  -H "X-API-Key: $API_KEY"

# 6. Deploy the better version
curl -X POST https://api.tradeready.io/api/v1/strategies/$STRATEGY_ID/deploy \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{"version": 2}'

import time
from agentexchange import AgentExchangeClient

with AgentExchangeClient(api_key="ak_live_...") as client:
    # 1. Create strategy
    strategy = client.create_strategy(
        name="RSI Mean Reversion",
        definition={
            "pairs": ["BTCUSDT", "ETHUSDT"],
            "timeframe": "1h",
            "entry_conditions": {"rsi_below": 30},
            "exit_conditions": {"take_profit_pct": 5, "stop_loss_pct": 2},
            "position_size_pct": 10,
            "max_positions": 3,
        },
    )
    sid = strategy.strategy_id

    # 2. Run 20 episodes over all of 2025
    test = client.start_strategy_test(
        strategy_id=sid,
        version=1,
        episodes=20,
        date_range_start="2025-01-01T00:00:00Z",
        date_range_end="2025-12-31T23:59:59Z",
        episode_duration_days=30,
    )

    # 3. Poll until done
    while test.status not in ("completed", "failed", "cancelled"):
        time.sleep(10)
        test = client.get_strategy_test(sid, test.test_run_id)
        print(f"Progress: {test.progress_pct:.0f}%")

    # 4. Read recommendations
    for rec in test.recommendations or []:
        print(f"Recommendation: {rec}")

    # 5. Create v2, test, and compare
    v2 = client.create_strategy_version(
        strategy_id=sid,
        definition={
            "pairs": ["BTCUSDT", "ETHUSDT"],
            "timeframe": "1h",
            "entry_conditions": {"rsi_below": 30, "adx_above": 20},
            "exit_conditions": {"take_profit_pct": 5, "stop_loss_pct": 1.5},
            "position_size_pct": 8,
            "max_positions": 3,
        },
        change_notes="Added ADX filter, tighter stop",
    )

    comparison = client.compare_strategy_versions(sid, v1=1, v2=2)
    print(comparison.verdict)