Kısa cevap: Paribu API key, dokümana göre paribu.com hesabında Account ve Other Security Settings yolundan oluşturulur; özel istekler Authorization ve X-Signature başlıklarıyla HMAC-SHA256 imzası ister, piyasa verisi ve herkese açık WebSocket akışı anahtarsız okunur. Paribu'nun ana sayfası kullanıcının kendi algoritmik botunu API ile kullanabileceğini yazar; Kullanım Şartları ise önceden yazılı izin olmadan otomatik program ve robot kullanımını yasak işler arasında sayar. Dokümanda test ortamı tarif edilmez ve emirler zararla sonuçlanabilir. Paribu Kripto Varlık Alım Satım Platformu AŞ, SPK'nın 28 Ekim 2026 tarihli geçici Faaliyette Bulunanlar Listesi'ndedir; SPK'ya göre listede yer almak yetkilendirme anlamına gelmez.
Bu yazı Paribu'nun kendi API dokümanını ve sözleşmesini Türkçe özetleyen teknik bir rehberdir. Tanıtım veya platform, varlık, strateji ve ayar önerisi değildir; platformu başka bir kuruluşla karşılaştırmaz. Bilgiler 4 ve 5 Kasım 2026'da kontrol edilmiştir ve doküman değişebilir.
Kod örnekleri gerçek anahtar içermez ve bir varlık adı yazdırmaz. Veri API'si ile platform API'si ayrımı kripto API yazısında, başka bir platformun dokümanı BtcTurk API yazısında anlatılıyor.
Paribu API dokümanı nerede, neleri kapsar?
Paribu API dokümanı docs.paribu.com/api adresindedir ve paribu.com ana sayfasının alt menüsündeki API dokümantasyonu bağlantısı bu adrese gider (4 Kasım 2026). Taban adres https://api.paribu.com olarak yazılıdır.
| Bölüm | İçerik |
|---|---|
| Market Data | Ticker, emir defteri, son işlemler ve işlem kuralları dosyası (/initials/config) |
| Orders | Limit, limit maker, piyasa, koşullu ve OCO emirleri; POST /order ve POST /v2/order |
| Account | Kullanıcı bilgisi, varlıklar, transferler, işlem geçmişi |
| Deposit and Withdrawals | Yatırma adresi, çekim ve Travel Rule beyanları |
| Streams | Herkese açık ve özel WebSocket akışları |
Ana sayfadaki kısa kod örneği emir adresini www.paribu.com altında gösterir, doküman ise api.paribu.com yazar. Bu yazı dokümanı esas alır. Kimlik doğrulama sayfası uç nokta yollarına /api öneki eklenmemesini ister; kota sayfasındaki tablo ise aynı yolları bu önekle listeler. Bu yüzden yol, dokümandan kopyalanmadan önce canlı yanıtla sınanır.
Paribu API key nasıl alınır?
Paribu API anahtarı, hesaba giriş yapıldıktan sonra dokümanın Account ve Other Security Settings diye adlandırdığı yoldan, Create API Key düğmesiyle oluşturulur.
- Anahtara tanınacak bir ad verilir.
- İzin seti seçilir.
- İstenirse IP whitelist eklenir; doküman bunu güvenlik için önerir.
- Sistem isterse iki aşamalı doğrulamayla onay verilir.
- API Key ve API Secret gösterilir. Doküman, gizli anahtarın yalnızca bu anda görüntüleneceğini yazar.
| İzin seti | Kapsam |
|---|---|
| Read-only | Hesap ve piyasa verisini okur, emir gönderemez |
| Trade | Okuma setine ek olarak order:create ve order:cancel |
| Full access | Tüm okuma ve yazma izinleri |
| Custom | Kapsamlar tek tek seçilir |
Emir göndermek için çekim kapsamı gerekmez; POST /withdraw uç noktası dokümanda withdraw:create kapsamına bağlıdır. Aynı dokümanın Scopes and Permissions sayfası ise kapsamların anahtar oluşturulurken özelleştirilemeyeceğini yazar. İki sayfa örtüşmediği için bir anahtarın çekim yetkisi taşıyıp taşımadığı oluşturma ekranından kontrol edilir. Saklama ve iptal adımları API anahtarı yazısında yer alıyor; burada ayar önerilmez.
Paribu API imzası nasıl üretilir?
Paribu özel istekleri, gizli anahtarla üretilen HMAC-SHA256 değerinin Base64 hâlini X-Signature başlığında ister. Authorization başlığı ham API anahtarını taşır, Bearer öneki kullanılmaz. X-Timestamp milisaniye cinsindendir; doküman bu başlığı şimdilik isteğe bağlı sayar, gelecek bir sürümde zorunlu olacağını yazar ve gönderildiğinde sunucu saatinden en çok ±5 saniye sapmasını ister.
import base64, hashlib, hmac
# Uydurma değerler: gerçek bir hesaba ait değildir
gizli = "ornek-gizli-anahtar"
zaman = "1700000000000"
sorgu = "limit=10"
govde = ""
metin = zaman + sorgu + govde
imza = base64.b64encode(hmac.new(gizli.encode(), metin.encode(), hashlib.sha256).digest()).decode()
print(metin)
print(imza)Çıktı (kod 4 Kasım 2026'da çalıştırılmıştır, ağa bağlanmaz):
1700000000000limit=10
g9Xak4kod/2xMtyulemPu82VEGHJ38XDBOQDTobg3+o=- İmza metni: Zaman damgası, sorgu metni ve gövde ayırıcısız birleştirilir. İstek yolu imzaya girmez.
- Gövde:
GETveDELETEiçin boş metindir;POSTiçin ağa giden baytların aynısı imzalanır. - Kodlama: Base64, onaltılık metne değil ham HMAC baytlarına uygulanır.
- Hata kodları: 401 yanlış anahtar, imza veya zaman; 403 izinli listede olmayan IP veya eksik kapsam anlamına gelir.
- İstemci adı: Dokümanın örnek kodu, bazı HTTP kütüphanelerinin varsayılan
User-Agentdeğerinin reddedilebildiğini not eder.
Paribu API limitleri nasıl işler?
Paribu API limitleri kullanıcı başınadır: GET istekleri dakikalık ağırlık havuzundan düşer, emir gönderme ve iptal ise ayrı saniyelik sınıra tabidir.
| Limit | Değer |
|---|---|
| Dakikalık ağırlık | 100.000 |
| Saniyede emir oluşturma | 25 |
| Saniyede emir iptali | 25 |
| Ticker ağırlığı | 1 |
| Emir defteri, kullanıcı, varlık, emir detayı ağırlığı | 2 |
| Açık emirler ağırlığı | 5 |
| Transfer geçmişi ağırlığı | 10 |
| İşlem geçmişi ağırlığı | 20 |
Kalan ağırlık X-Quota-Remaining başlığında döner. Sınır aşılınca 429 kodu ve Retry-After başlığı gelir; gövdedeki retry_after saniyelik sınırda 1, ağırlık sınırında bir sonraki dakikaya kalan süredir. Doküman daha yüksek limit için VIP programına yönlendirir.
Paribu WebSocket akışı nasıl kullanılır?
Paribu WebSocket akışı için dokümanda iki nesil adres vardır: Streams bölümündeki adresler ve beta olarak işaretlenen WebSocket API adresleri.
| Adres | Kanal örnekleri | Kimlik doğrulama |
|---|---|---|
wss://api.paribu.com/stream | ticker24h, book-ticker, matches, orderbook-diff | Yok |
wss://api.paribu.com/stream/user | user-matches, user-matches-with-fee, orders | Başlıkta imza; imza metni yalnızca zaman damgası |
wss://api.paribu.com/v1/wapi/stream (beta) | orderbook, match-price, book-ticker, matches | Yok |
wss://api.paribu.com/v1/wapi/user (beta) | orders, ledger | API anahtarı ve imza |
Beta sayfası, mesaj biçimi ve kanal adlarının değişebileceğini ve kullanım riskinin kullanıcıda olduğunu yazar. Aynı sayfaya göre sunucu 20 saniyede bir ping gönderir, 30 saniye içinde pong gelmezse bağlantıyı kapatır ve herhangi bir kopma yeniden bağlanma işareti sayılır. Özel akış için anahtarda okuma setindeki kapsamlar bulunmalıdır. Aşağıdaki kod 4 Kasım 2026'da anahtarsız çalıştırılmıştır (websockets 13.1); piyasa adı ve fiyat değil, yalnızca alan adlarını yazdırır.
import asyncio, json, requests, websockets
BASLIK = {"User-Agent": "ornek-istemci/1.0"}
liste = requests.get("https://api.paribu.com/market/ticker", headers=BASLIK, timeout=10)
liste.raise_for_status()
piyasa = liste.json()[0]["market"] # ekrana yazdırılmaz
async def dinle():
async with websockets.connect("wss://api.paribu.com/stream") as ws:
await ws.send(json.dumps({"method": "subscribe", "channels": [f"ticker24h:{piyasa}"], "id": "istek-1"}))
for _ in range(2):
mesaj = json.loads(await asyncio.wait_for(ws.recv(), timeout=20))
print(sorted(mesaj.keys()))
asyncio.run(dinle())Çıktı:
['channel', 'code', 'id', 'method', 'status']
['E', 'e', 'market', 'r', 's']İlk satır abonelik onayıdır. İkinci satırdaki market alanı, dokümanın ticker örneğinde görünmez; bu yüzden yazılım beklenmeyen alanlarda durmayacak biçimde kurulur. Akış kanalının genel mantığı REST ve WebSocket yazısında anlatılıyor.
Paribu bot kullanımı: site ve sözleşme ne diyor?
Paribu'nun ana sayfası, API ile emirlerin otomatikleştirilebileceğini ve kullanıcının kendi algoritmik botunu kullanabileceğini yazar; 29 Temmuz 2026 tarihli Kullanım Şartları ise önceden yazılı izin olmadan otomatik program ve robot kullanımını yasak işler arasında sayar. Yasal Bilgilendirmeler sayfasında API'ye özel bir kullanım koşulları metni yoktur; 14 Nisan 2026 tarihli Çerçeve Sözleşme'de bot kelimesi geçmez.
| Metin ve madde | Özet |
|---|---|
| Kullanım Şartları 5.19(v) | Önceden yazılı izin olmadan Platform üzerinde otomatik program, robot, web crawler, örümcek, veri madenciliği ve veri taraması gibi screen scraping yazılımları kullanılamaz. |
| Kullanım Şartları 5.20 | Platform'a robot veya otomatik giriş yöntemleriyle girilmeyeceği kabul edilir. |
| Emir Gerçekleştirme Politikası 4.1.3 (3 Ağustos 2026) | Emirler yalnızca internet sitesi, mobil uygulama veya API üzerinden iletilebilir. |
| Çerçeve Sözleşme 4.4 | Hesapta müşteri ve noter vekaletnamesiyle yetkilendirilen kişiler işlem yapabilir; portföy yöneticiliği hükümleri saklıdır. |
| Çerçeve Sözleşme 4.5 | Müşteri, izinsiz sermaye piyasası faaliyeti sonucunu doğuracak şekilde birden fazla kişi adına veya temsilci sıfatıyla işlem yapamaz. |
| Çerçeve Sözleşme 10.4(a) | Şifre ve onay kodları üçüncü kişilerle paylaşılmaz. API anahtarı bu maddede adıyla sayılmaz. |
| Çerçeve Sözleşme 13.13 | Üçüncü taraf platform veya API üzerinden gönderilen emirlerdeki bağlantı ve gecikme sorunlarından Paribu sorumlu tutulamaz; bu emirler limit kontrollerine tabi olabilir. |
Ana sayfadaki cümle bir tanıtım metnidir, sözleşme hükmü değildir; belirli bir kullanımın uygun olduğu sonucu buradan çıkarılmaz. Kullanım Şartları'ndaki Platform tanımı paribu.com ile alt alan adlarını ve mobil uygulamaları kapsar, API'yi adıyla saymaz; API'nin adresi olan api.paribu.com ise bir alt alan adıdır. 5.19(v) hükmü de screen scraping yazılımlarını anar. Bu hükümlerin API ile gönderilen emirlere nasıl uygulanacağı metinde açık değildir, bu yüzden otomatik yazılımdan önce platformdan yazılı teyit alınması en açık yoldur. Başkasının hesabında işlem yapmak, anahtarı devretmek veya sinyal aboneliğini hesaba bağlamak gibi durumlar için platforma ve hukuk danışmanına sorulması gerekir.
- Kaldıraç: III-35/B.2 sayılı Tebliğ'in 14. maddesine göre platformlarda listelenen kripto varlıklar kaldıraçlı alınıp satılamaz.
- Hesap yönetimi: Aynı Tebliğ'in 15/3 hükmü, müşteri portföylerinin menfaat sağlamak üzere vekil sıfatıyla veya bu sonucu doğuran sözlü yetkiyle yönetilmesini yasaklar.
- Yurt dışı platformlar: 6362 sayılı Kanun'un 99/A maddesine göre yurt dışında yerleşik platformların Türkiye'de yerleşik kişilere yönelik faaliyeti izinsiz sayılır.
Liste ve lisans farkı kripto varlık hizmet sağlayıcı yazısında anlatılıyor. Müşterinin yazılı olarak belirlediği kuralların yazılıma dönüştürülmesi işi borsa API entegrasyonu sayfasındadır; Fincode strateji önermez, kararlar müşteriye aittir. Bot kazanç anlamına gelmez, yazılımla gönderilen emirler de zararla sonuçlanabilir. Yazı hukuki görüş değildir.
Paribu API GitHub: resmi kütüphane var mı?
4 Kasım 2026'da okunan 35 doküman sayfasının hiçbirinde bir GitHub kütüphanesine bağlantı yoktur; doküman REST için Python ve Node.js örneklerini dilin kendi araçlarıyla verir.
GitHub'da Paribu Teknoloji AS adını ve paribu.com adresini gösteren bir kuruluş hesabı vardır. Hesapta 7 herkese açık depo görünür; açıklamalarında bu API için bir istemci kütüphanesi yer almaz, doğrulama rozeti de görülememiştir. Aramada çıkan istemci depolarının bir bölümü kendini resmi olmayan proje olarak tanımlar.
Topluluk kütüphanesi kullanılacaksa gizli anahtar bu koda verilir. Bu nedenle kaynak kod okunur, imzanın yerel üretildiği ve anahtarın başka bir adrese gönderilmediği kontrol edilir, sürüm sabitlenir. Doküman değiştiğinde topluluk kodu geride kalabilir.
Paribu API'de test ortamı var mı, ilk emirde risk nedir?
Dokümanın 35 sayfasında sandbox, testnet veya demo ortamı tarif edilmez; bu yüzden gerçek emir akışı ancak gerçek hesapta ve gerçek bakiyeyle sınanabilir. Küçük tutarlı emir de gerçek emirdir: komisyon öder, gerçekleşebilir ve zararla kapanabilir.
- Emirsiz sınama: Herkese açık uç noktalar anahtarsız, imza ise emir göndermeyen imzalı bir okuma isteğiyle denenebilir.
- İstemci kimliği:
newClientOrderIdyalnızcaPOST /v2/orderile gönderilir. Doküman bunun yinelenen isteği engelleyen bir anahtar olmadığını açıkça yazar. - Zaman aşımı: Doküman, ayrıntılı yanıt zamanında gelmezse emrin normal akışında sürdüğünü, son durumun açık emirler veya emir detayı sorgusuyla öğrenileceğini söyler.
- Kuru çalıştırma: Emir akışı canlıya geçmeden sanal bakiyeyle denenebilir; yöntem paper trading yazısında anlatılıyor.
Sık sorulan sorular
Paribu API key nasıl alınır?
Dokümana göre paribu.com hesabına girildikten sonra Account ve Other Security Settings yolundan Create API Key seçilir, izin seti belirlenir ve istenirse IP whitelist eklenir. Gizli anahtar yalnızca oluşturma anında gösterilir.
Paribu WebSocket için anahtar gerekir mi?
Piyasa verisi akışları anahtarsızdır. Kullanıcının emir ve işlem olaylarını taşıyan özel akışlar API anahtarı ve imza ister; imza WebSocket bağlantı isteğinin başlıklarında gönderilir.
Paribu API için resmi GitHub kütüphanesi var mı?
4 Kasım 2026'da okunan doküman sayfalarında GitHub kütüphanesine bağlantı yoktur. Aramada görülen istemci depolarının platformla ilişkisi doğrulanmamıştır; bir bölümü kendini resmi olmayan proje olarak tanımlar.
Paribu bot kullanımı serbest mi?
Ana sayfa kullanıcının kendi algoritmik botunu API ile kullanabileceğini yazar; Kullanım Şartları ise önceden yazılı izin olmadan otomatik program ve robot kullanımını yasak işler arasında sayar. İkisinin API emirlerinde nasıl birlikte okunacağı açık değildir, platformdan yazılı teyit alınması en açık yoldur. Emirler zararla sonuçlanabilir.
Paribu API'de test ortamı var mı?
4 Kasım 2026'da okunan dokümanda sandbox, testnet veya demo ortamı tarif edilmez. Herkese açık uç noktalar anahtarsız okunur; gerçek emir akışı ise gerçek hesapla çalışır.
Paribu API ile çekim yapılabilir mi?
Dokümanda çekim uç noktası vardır ve withdraw:create kapsamı ister. Emir göndermek için bu kapsam gerekmez. Anahtarın kapsamı oluşturma ekranından kontrol edilir.
Kaynaklar
- Paribu API dokümanı: Obtaining API Keys (yeni sekmede açılır)
- Paribu API dokümanı: Authentication and Signing (yeni sekmede açılır)
- Paribu API dokümanı: Scopes and Permissions (yeni sekmede açılır)
- Paribu API dokümanı: Rate Limiting (yeni sekmede açılır)
- Paribu API dokümanı: Streams (yeni sekmede açılır)
- Paribu API dokümanı: WebSocket API Overview (beta) (yeni sekmede açılır)
- Paribu API dokümanı: Placing Orders (yeni sekmede açılır)
- Paribu API dokümanı: Client Order ID (v2) (yeni sekmede açılır)
- Paribu: ana sayfa, Geliştiriciler için bölümü (4 Kasım 2026) (yeni sekmede açılır)
- Paribu: Kripto Varlık Hizmetleri Çerçeve Sözleşmesi (14 Nisan 2026) (yeni sekmede açılır)
- Paribu: Kullanım Şartları ve Üyelik Sözleşmesi (29 Temmuz 2026) (yeni sekmede açılır)
- Paribu: Emir Gerçekleştirme Politikası (3 Ağustos 2026) (yeni sekmede açılır)
- GitHub: Paribu Teknoloji AS kuruluş hesabı (yeni sekmede açılır)
- SPK: Faaliyette Bulunanlar Listesi (Geçici Liste, 28 Ekim 2026) (yeni sekmede açılır)
- III-35/B.2 sayılı Tebliğ, Resmî Gazete 13 Mart 2025, 32840 (yeni sekmede açılır)
Burada yer alan yatırım bilgi, yorum ve tavsiyeleri yatırım danışmanlığı kapsamında değildir. Yatırım danışmanlığı hizmeti, yetkili kuruluşlar tarafından kişilerin risk ve getiri tercihleri dikkate alınarak kişiye özel sunulmaktadır. Burada yer alan yorum ve tavsiyeler ise genel niteliktedir. Bu tavsiyeler mali durumunuz ile risk ve getiri tercihlerinize uygun olmayabilir. Bu nedenle, sadece burada yer alan bilgilere dayanılarak yatırım kararı verilmesi beklentilerinize uygun sonuçlar doğurmayabilir.