Developer API v1

TradeWize Developer API

Kimlik doğrulama, hesaplar, emirler, portföy verileri ve işlem otomasyonları için teknik dokümantasyon.

Base URL https://api.tradewize.com.tr

Erişim token’ı oluşturma cURL

Token oluşturAPI anahtarını yalnızca bu adımda kullanın.

curl -X POST https://api.tradewize.com.tr/oauth/token \
  -H "X-API-Key: tw_live_api_anahtariniz" \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"api_key"}'

200 OK access_token 24 saat geçerli

Başlangıç

API erişimini yapılandırın

API anahtarıyla erişim token’ı oluşturun ve yetkili isteklerde kullanın.

1 API anahtarı

API anahtarınızı alın

TradeWize yönetim panelindeki Geliştirici alanından canlı API anahtarınızı oluşturun.

Yönetim paneline git

2 OAuth 2.0

JWT token oluşturun

X-API-Key header’ı ile /oauth/token endpoint’inden erişim ve yenileme token’larını alın.

Kimlik doğrulamayı incele

3 Bearer token

Yetkili istek gönderin

JWT token’ınızı Authorization: Bearer header’ına ekleyerek API endpoint’lerini çağırın.

İstek örneğini gör

Kimlik doğrulama

Anahtarınızı istemci kodundan uzak tutun

API anahtarı yalnızca token üretmek için kullanılır. Diğer tüm çağrılar kısa ömürlü JWT access token ile yapılır.

Güvenli sunucunuzAPI Key

POST/oauth/token

Yetkili çağrılarBearer JWT

API anahtarını tarayıcıya veya mobil uygulamaya gömmeyin.

Anahtarı sunucu tarafında bir secret manager ya da ortam değişkeninde saklayın. Access token 24 saat, refresh token 30 gün geçerlidir.

Güvenlik rehberi

API isteği

Hesap listesini getirin

Token yanıtındaki access_token değerini Bearer token olarak gönderin.

GET /api/v1/accounts Hesapları listele

curl https://api.tradewize.com.tr/api/v1/accounts \
  -H "Authorization: Bearer JWT_TOKENINIZ" \
  -H "Accept: application/json"

Yanıt sözleşmesi

Tutarlı JSON, öngörülebilir hata yönetimi

Başarılı yanıtlar veriyi data içinde; başarısız yanıtlar makine tarafından okunabilir hata kodunu error içinde taşır.

200 OKBaşarılı yanıt

{
  "success": true,
  "data": [
    {
      "accountNumber": "ACC-ULID-001",
      "number": "12345",
      "name": "Ana Hesap",
      "brokerageCode": "TradeWiseYatirim",
      "brokerageName": "TradeWiseYatirim Menkul Değerler",
      "isActive": true,
      "isDefault": true
    }
  ]
}

400Hata yanıtı

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "İstek işlenemedi."
  }
}

Sonraki adımlar

İhtiyacınız olan kaynağa ilerleyin

Temel akış hazır. Entegrasyonunuzun bir sonraki parçasını seçin.

API referansıTüm endpoint, parametre ve yanıt şemaları Gerçek zamanlı akışlarSignalR ile emir ve portföy güncellemeleri MCP ServerMCP istemcilerini API araçlarına bağlayın Postman koleksiyonuTest API’si varsayılan; sandbox değildir ve gerçek hesabı etkileyebilir Postman environmentTest ve production adresleri; test API’si gerçek hesabınıza bağlıdır PDF referansıTüm API dokümantasyonunu çevrimdışı okuyun