TradeWise Geliştirici API'si

Güçlü ticaret uygulamaları geliştirin. Gerçek zamanlı piyasa verilerine erişin, portföy yönetin ve programatik olarak işlem yapın.

Hızlı Başlangıç Kimlik Doğrulama Rehberi

Hızlı Başlangıç

TradeWise API'ye 3 basit adımda başlayın. Dakikalar içinde ilk API çağrınızı yapacaksınız.

1

API Anahtarınızı Alın

TradeWise hesabınıza giriş yapın ve panonuzdaki Geliştirici bölümüne gidin.

Panele Git
2

Kimlik Doğrulama

API anahtarınızı kullanarak JWT token alın. Token'ı sonraki tüm API isteklerinizde kullanın. 

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

Yanıtta gelen access token 24 saat, refresh token 30 gün geçerlidir. Access token süresi dolmadan refresh token ile yeni token seti alın.

3

İlk İsteğinizi Yapın

JWT token'ı kullanarak herhangi bir API endpoint'ini çağırın. İşte sembol listelerinizi almak için bir örnek: 

curl -X GET https://devapi.tradewise.com.tr/api/v1/symbol-lists \
  -H "Authorization: Bearer jwt_tokeniniz"

Temel URL

Tüm API istekleri aşağıdaki temel URL'e yapılmalıdır:

https://devapi.tradewise.com.tr

Kimlik Doğrulama

TradeWise API, API anahtarları ve JWT token'ları ile OAuth 2.0 Client Credentials akışını kullanır.

API anahtarı yalnızca /oauth/token endpoint'inde kullanılır. Diğer tüm Developer API çağrılarında Authorization: Bearer JWT_TOKENINIZ header'ı gönderilmelidir.

Önemli: API anahtarınız hassas bir bilgidir. Asla herkese açık olarak paylaşmayın veya versiyon kontrolüne eklemeyin. Anahtarlarınızı saklamak için ortam değişkenlerini kullanın.

Detaylı kimlik doğrulama dokümantasyonu için Kimlik Doğrulama Rehberi'ne bakın.

İstek Yapma

Tüm istekler Authorization header'ında JWT token içermelidir: 

curl -X GET https://devapi.tradewise.com.tr/api/v1/endpoint \
  -H "Authorization: Bearer JWT_TOKENINIZ" \
  -H "Content-Type: application/json"

Yanıt Formatı

Tüm API yanıtları JSON formatında döner. Başarılı yanıtlar 2xx durum koduna sahip olacaktır.

Başarılı Yanıt Örneği

{
  "success": true,
  "data": {
    "id": 123,
    "name": "Örnek Veri"
  }
}

Hata Yanıtı Örneği

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "İstek geçersiz veya işlenemez.",
    "details": "Gerekli alan eksik: symbol"
  }
}

Sonraki Adımlar

Artık temelleri öğrendiğinize göre, uygulamanızı geliştirmek için bu kaynakları inceleyin:

Kimlik Doğrulama Rehberi

OAuth 2.0, API anahtarları ve JWT token'ları hakkında bilgi edinin.

API Referansı

Tüm mevcut endpoint'lerin tam referansı.

Kod Örnekleri

C#, Python, JavaScript ve daha fazlasında kullanıma hazır örnekler.

Hata İşleme

Hata kodlarını anlayın ve bunları nasıl ele alacağınızı öğrenin.