Python SDK

pip install vectrade

pip install vectrade[telemetry]   # OpenTelemetry integration
pip install vectrade[pandas]      # DataFrame helpers

from vectrade import VecTrade

client = VecTrade()  # reads VECTRADE_API_KEY env var

quote = client.quotes.get("AAPL")
print(f"{quote.symbol}: ${quote.price}")

from vectrade import AsyncVecTrade

async def main():
    client = AsyncVecTrade()
    quote = await client.quotes.get("AAPL")
    print(f"{quote.symbol}: ${quote.price}")

client = VecTrade(
    api_key="vq_live_...",       # or VECTRADE_API_KEY env var
    base_url="https://...",      # custom endpoint
    timeout=30,                  # request timeout (seconds)
    max_retries=2,               # automatic retries on 429/5xx
    sandbox=True,                # use sandbox environment
)

quote = client.quotes.get("AAPL")
print(f"{quote.symbol}: ${quote.price:.2f} ({quote.change_pct:+.2f}%)")

quotes = client.quotes.batch(["AAPL", "MSFT", "GOOGL"])
for q in quotes:
    print(f"{q.symbol}: ${q.price:.2f}")

tech = client.technicals.get("AAPL")
print(f"Score: {tech.technical_score}/100")
print(f"RSI: {tech.indicators['rsi']['value']:.1f} ({tech.indicators['rsi']['signal']})")
print(f"Trend: {tech.summary['trend']}")

analyst = client.analyst.consensus("AAPL")
print(f"Rating: {analyst.consensus} | Signal: {analyst.signal}")
print(f"Analysts: {analyst.total_analysts}")

from vectrade import RateLimitError, NotFoundError

try:
    quote = client.quotes.get("INVALID")
except NotFoundError as e:
    print(f"Not found: {e} (request_id: {e.request_id})")
except RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")