HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1716220800

Authorization: Bearer vtrd_live_your_api_key_here

curl -X GET "https://api.vectrade.com/v1/market/quote?symbol=AAPL" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "symbol": "AAPL",
  "exchange": "NASDAQ",
  "price": 189.45,
  "bid": 189.43,
  "ask": 189.47,
  "change": 2.31,
  "changePercent": 1.24,
  "volume": 52341000,
  "avgVolume": 48200000,
  "marketCap": 2940000000000,
  "dayHigh": 190.12,
  "dayLow": 186.80,
  "previousClose": 187.14,
  "timestamp": "2024-01-15T16:00:00Z"
}

curl -X POST "https://api.vectrade.com/v1/trading/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "AAPL",
    "exchange": "NASDAQ",
    "side": "BUY",
    "orderType": "LIMIT",
    "quantity": 10,
    "limitPrice": 185.00,
    "timeInForce": "GTC"
  }'

{
  "orderId": "ord_8f3a2b1c4d5e6f7a",
  "symbol": "AAPL",
  "side": "BUY",
  "orderType": "LIMIT",
  "quantity": 10,
  "limitPrice": 185.00,
  "timeInForce": "GTC",
  "status": "WORKING",
  "createdAt": "2024-01-15T14:23:45Z"
}

curl -X GET "https://api.vectrade.com/v1/portfolio/positions" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "positions": [
    {
      "symbol": "AAPL",
      "exchange": "NASDAQ",
      "side": "LONG",
      "quantity": 50,
      "averageCost": 178.32,
      "currentPrice": 189.45,
      "marketValue": 9472.50,
      "unrealizedPnl": 556.50,
      "unrealizedPnlPercent": 6.24,
      "weight": 12.3
    }
  ],
  "totalEquity": 1052340.00,
  "cashBalance": 876200.00
}

from vectrade import VecTrade

# Initialize client with API key
client = VecTrade(api_key="vtrd_live_your_api_key_here")

# --- Market Data ---
quote = client.market.get_quote(symbol="AAPL")
print(f"{quote.symbol}: ${quote.price} ({quote.change_percent:+.2f}%)")

# Get historical data
history = client.market.get_history(
    symbol="NVDA",
    interval="1d",
    period="6mo"
)
for candle in history[-5:]:
    print(f"  {candle.date}: O={candle.open} H={candle.high} L={candle.low} C={candle.close}")

# --- Trading ---
# Place a market order
order = client.trading.place_order(
    symbol="AAPL",
    exchange="NASDAQ",
    side="BUY",
    order_type="MARKET",
    quantity=10
)
print(f"Order {order.id}: {order.status} — filled at ${order.fill_price}")

# Place a limit order with GTC
limit_order = client.trading.place_order(
    symbol="NVDA",
    exchange="NASDAQ",
    side="BUY",
    order_type="LIMIT",
    quantity=5,
    limit_price=800.00,
    time_in_force="GTC"
)

# Cancel an order
client.trading.cancel_order(order_id=limit_order.id)

# --- Portfolio ---
positions = client.portfolio.get_positions()
for pos in positions:
    pnl_emoji = "📈" if pos.unrealized_pnl > 0 else "📉"
    print(f"  {pnl_emoji} {pos.symbol}: {pos.quantity} shares, P&L: ${pos.unrealized_pnl:.2f}")

# Get account summary
account = client.portfolio.get_summary()
print(f"Total Equity: ${account.total_equity:,.2f}")
print(f"Cash: ${account.cash_balance:,.2f}")
print(f"Day P&L: ${account.day_pnl:,.2f}")

import { VecTrade } from '@vectrade/sdk';

// Initialize client
const client = new VecTrade({ apiKey: 'vtrd_live_your_api_key_here' });

// --- Market Data ---
const quote = await client.market.getQuote({ symbol: 'AAPL' });
console.log(`${quote.symbol}: $${quote.price} (${quote.changePercent}%)`);

// Get key statistics
const stats = await client.market.getStats({ symbol: 'NVDA' });
console.log(`NVDA P/E: ${stats.peRatio}, Market Cap: $${stats.marketCap}`);

// --- Trading ---
// Place a bracket order
const order = await client.trading.placeOrder({
  symbol: 'AAPL',
  exchange: 'NASDAQ',
  side: 'BUY',
  orderType: 'BRACKET',
  quantity: 20,
  takeProfitPrice: 200.00,
  stopLossPrice: 175.00,
  timeInForce: 'GTC',
});
console.log(`Bracket order ${order.orderId}: ${order.status}`);

// --- Portfolio ---
const positions = await client.portfolio.getPositions();
positions.forEach((pos) => {
  console.log(`${pos.symbol}: ${pos.quantity} @ $${pos.averageCost} → $${pos.currentPrice}`);
});

// Get performance metrics
const metrics = await client.portfolio.getMetrics({ period: '1M' });
console.log(`Monthly Return: ${metrics.totalReturn}%`);
console.log(`Sharpe Ratio: ${metrics.sharpeRatio}`);