Beta - v1.0

API Dokümantasyonu

Premium planı ile Alvest API'ye erişin. Portföy verilerini kendi uygulamalarınıza entegre edin.

Kimlik Doğrulama

Her isteğe Authorization header ekle:

Authorization: Bearer alv_mcp_••••••••

Kalıcı API anahtarını uygulamada → API & Entegrasyonlar bölümünden üret (aynı anahtar hem MCP hem REST API için geçerli). Anahtar bir kez gösterilir - güvenli sakla.

curl https://alvest.app/api/v1/portfolio?resource=holdings \
  -H "Authorization: Bearer alv_mcp_xxxx_xxxxxxxx"

Alternatif: tarayıcı oturumundan kısa ömürlü Supabase JWT (session.access_token) de çalışır.

Hız Sınırları

Saatte 100 istek. Yanıt header'larında kalan limit görünür.

X-RateLimit-Limit: 100
X-RateLimit-Window: 3600

Endpoint'ler

GETPremium

/api/v1/portfolio

API özetini ve mevcut endpoint listesini döndürür.

Örnek Yanıt

{
  "ok": true,
  "plan": "premium",
  "counts": { "crypto_positions": 4, "transactions": 12, ... },
  "latest_snapshot": { "value_usd": 18420.5, "date": "2026-06-23" },
  "endpoints": {...}
}

GETPremium

/api/v1/portfolio?resource=holdings

Güncel pozisyonların (kripto + işlemlerden türetilmiş hisse/fon net pozisyonları).

Örnek Yanıt

{
  "ok": true,
  "holdings": [
    { "symbol": "BTC", "qty": 0.25, "avg_cost": 61000, "currency": "USD", "asset_class": "crypto" },
    { "symbol": "THYAO", "qty": 100, "avg_cost": 285.4, "currency": "TRY", "asset_class": "equity" }
  ]
}

GETPremium

/api/v1/portfolio?resource=transactions

Ham işlem defteri (alış/satış kayıtları).

Örnek Yanıt

{
  "ok": true,
  "count": 12,
  "transactions": [
    { "date": "2026-01-10", "ticker": "BTC", "type": "Buy", "qty": 0.1, "price": 60000, "currency": "USD" }
  ]
}

GETPremium

/api/v1/portfolio?resource=watchlist

İzleme listen (hedef alış/satış seviyeleriyle).

Örnek Yanıt

{
  "ok": true,
  "count": 3,
  "watchlist": [
    { "ticker": "ETH", "target_buy": 2800, "target_sell": 4200 }
  ]
}

GETPremium

/api/v1/portfolio?resource=prices&symbols=BTC,ETH

Kripto veya hisse fiyatlarını döndürür.

Parametreler

Name	Type	Description
`symbols`	string	Comma-separated symbols. E.g. BTC,ETH,SOL

Örnek Yanıt

{
  "ok": true,
  "data": {
    "BTC": { "price": 65420.5, ... }
  }
}

GETPremium

/api/v1/portfolio?resource=exchange_rate

USD/TRY kurunu TCMB üzerinden döndürür.

Örnek Yanıt

{
  "ok": true,
  "data": { "rate": 32.45, "source": "TCMB" }
}