API Reference

RESTful API for programmatic access to HedgeVision capabilities.

Authentication

API Key Authentication

Include your API key in the Authorization header of all requests:

Authorization: Bearer hv_sk_xxxxxxxxxxxxx

Base URL

https://api.hedgevision.io/v1

Endpoints

GET/api/v1/signals

List active trading signals

asset?timeframe?limit?

POST/api/v1/orders

Submit a new order

assetsidequantitytype

GET/api/v1/portfolio

Get current portfolio state

GET/api/v1/risk/exposure

Current risk exposure metrics

breakdown?

POST/api/v1/backtest

Run strategy backtest

strategy_idstart_dateend_date

GET/api/v1/models/{id}/predictions

Get model predictions

horizon?assets?

Example Request

curl -X POST https://api.hedgevision.io/v1/orders \
  -H "Authorization: Bearer hv_sk_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": "AAPL",
    "side": "BUY",
    "quantity": 100,
    "type": "LIMIT",
    "price": 185.50,
    "time_in_force": "DAY"
  }'

Rate Limits

Free

100/min

Burst: 10/sec

Pro

1,000/min

Burst: 50/sec

Enterprise

10,000/min

Burst: 500/sec

SDKs

Pythonpip install hedgevision

TypeScriptnpm install @hedgevision/sdk

Gogo get hedgevision.io/sdk

Rustcargo add hedgevision