Agent Onboarding

# Register for API key
curl -X POST https://arcquant.xyz/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "0xYourWallet"}'

# Discover strategy schema
curl https://arcquant.xyz/api/v1/schema \
  -H "Authorization: Bearer aq_YOUR_KEY"

# Get signals
curl "https://arcquant.xyz/api/signals?strategyId=strat-rsi-oversold&symbol=ETH/USDT" \
  -H "Authorization: Bearer aq_YOUR_KEY"

# Run backtest
curl -X POST https://arcquant.xyz/api/backtest \
  -H "Authorization: Bearer aq_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "strategyId": "strat-momentum-scalper",
    "symbol": "BTC/USDT",
    "startDate": "2025-06-01",
    "endDate": "2026-03-01"
  }'

# Check usage
curl https://arcquant.xyz/api/auth/usage \
  -H "Authorization: Bearer aq_YOUR_KEY"

# Revoke key
curl -X POST https://arcquant.xyz/api/auth/revoke \
  -H "Content-Type: application/json" \
  -d '{"key": "aq_YOUR_KEY"}'

import requests

BASE = "https://arcquant.xyz"

# 1. Register
resp = requests.post(f"{BASE}/api/auth/register", json={
    "walletAddress": "0xYourWallet",
    "name": "my-python-agent"
})
api_key = resp.json()["apiKey"]
headers = {"Authorization": f"Bearer {api_key}"}

# 2. Discover available indicators & node types
schema = requests.get(f"{BASE}/api/v1/schema", headers=headers).json()
print(f"Available indicators: {len(schema['indicatorNodes']['indicators'])}")

# 3. List strategies
strategies = requests.get(f"{BASE}/api/strategies", headers=headers).json()
for s in strategies["data"][:5]:
    print(f"  {s['id']}: {s['name']}")

# 4. Get live signals
signals = requests.get(
    f"{BASE}/api/signals",
    params={"strategyId": "strat-momentum-scalper", "symbol": "BTC/USDT"},
    headers=headers
).json()
for sig in signals.get("signals", []):
    print(f"  {sig['direction']} @ confidence {sig['confidence']:.2f}")

# 5. Run backtest
bt = requests.post(f"{BASE}/api/backtest", headers=headers, json={
    "strategyId": "strat-momentum-scalper",
    "symbol": "BTC/USDT",
    "startDate": "2025-06-01",
    "endDate": "2026-03-01"
}).json()
print(f"Win rate: {bt['portfolio']['winRate']:.1f}%")
print(f"Return: {bt['portfolio']['totalReturnPct']:.2f}%")
print(f"Sharpe: {bt['metrics']['sharpeRatio']:.3f}")

# 6. Subscribe to webhook signals
sub = requests.post(f"{BASE}/api/signals/subscribe", headers=headers, json={
    "strategyId": "strat-momentum-scalper",
    "interval": "5m",
    "callbackUrl": "https://my-agent.example.com/webhook"
}).json()
print(f"Webhook secret: {sub['secret']}")  # Store securely!

# 7. Check usage
usage = requests.get(f"{BASE}/api/auth/usage", headers=headers).json()
print(f"Total API calls: {usage['totalCalls']}")

const BASE = "https://arcquant.xyz";

// 1. Register
const reg = await fetch(`${BASE}/api/auth/register`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ walletAddress: "0xYourWallet", name: "my-ts-agent" }),
});
const { apiKey } = await reg.json();
const headers = { Authorization: `Bearer ${apiKey}` };

// 2. Discover schema
const schema = await fetch(`${BASE}/api/v1/schema`, { headers }).then(r => r.json());
console.log(`${schema.indicatorNodes.indicators.length} indicators available`);

// 3. Get signals
const signals = await fetch(
  `${BASE}/api/signals?strategyId=strat-momentum-scalper&symbol=BTC/USDT`,
  { headers }
).then(r => r.json());

for (const sig of signals.signals ?? []) {
  console.log(`${sig.direction} @ confidence ${sig.confidence.toFixed(2)}`);
}

// 4. Run backtest
const bt = await fetch(`${BASE}/api/backtest`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    strategyId: "strat-momentum-scalper",
    symbol: "BTC/USDT",
    startDate: "2025-06-01",
    endDate: "2026-03-01",
  }),
}).then(r => r.json());

console.log(`Win rate: ${bt.portfolio.winRate.toFixed(1)}%`);
console.log(`Return: ${bt.portfolio.totalReturnPct.toFixed(2)}%`);
console.log(`Sharpe: ${bt.metrics.sharpeRatio.toFixed(3)}`);

// 5. Webhook handler (Express example)
import express from "express";
import { createHmac, timingSafeEqual } from "crypto";

const app = express();
app.post("/webhook", express.raw({ type: "*/*" }), (req, res) => {
  const signature = req.headers["x-arcquant-signature"] as string;
  const expected = createHmac("sha256", WEBHOOK_SECRET)
    .update(req.body)
    .digest("hex");

  if (!timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(signature, "hex"))) {
    return res.status(401).send("Invalid signature");
  }

  const payload = JSON.parse(req.body.toString());
  console.log(`Signal: ${payload.signal.direction} ${payload.signal.symbol}`);
  res.status(200).send("OK");
});
app.listen(8080);