altinapi Dokümantasyon

altinapi, gerçek zamanlı altın, döviz ve değerli metal fiyatları sağlayan bir REST API ve WebSocket servisidir. Aynı veri sağlayıcısından beslendiği için fiyatlar Harem Altın ile birebir örtüşür.

Hızlı Başlangıç

# API key ile tüm fiyatları çek
curl -H "X-API-Key: hapi_YOUR_KEY" \
  https://altinapi.com/api/v1/prices

Kimlik Doğrulama

Tüm fiyat endpoint'leri için geçerli bir API key gereklidir. API key'inizi Dashboard'dan oluşturabilirsiniz.

Header ile (Önerilen)

GET /api/v1/prices HTTP/1.1
Host: altinapi.com
X-API-Key: hapi_YOUR_API_KEY

Query Parameter ile

curl "https://altinapi.com/api/v1/prices?api_key=hapi_YOUR_KEY"

Rate Limits

İstekler dakika başına aşağıdaki sınırlara tabidir (kayan pencere):

Limit aşıldığında 429 Too Many Requests döner. Response header'larında limit bilgisi bulunur:

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 27
X-RateLimit-Reset: 1710000060

Fiyat Endpoints

curl https://altinapi.com/api/v1/prices \
  -H "X-API-Key: hapi_YOUR_KEY"

{
  "data": [
    {
      "symbol": "USDTRY",
      "category": "DOVIZ",
      "bid": 32.45,
      "ask": 32.48,
      "timestamp": 1710000000000
    },
    // ... tüm semboller
  ],
  "updatedAt": "2024-03-10T12:00:00.000Z",
  "stale": false
}

curl "https://altinapi.com/api/v1/prices/category/DOVIZ" \
  -H "X-API-Key: hapi_YOUR_KEY"

curl "https://altinapi.com/api/v1/prices/ALTIN" \
  -H "X-API-Key: hapi_YOUR_KEY"

{
  "symbol": "ALTIN",
  "category": "MADEN",
  "bid": 2312.50,
  "ask": 2315.00,
  "timestamp": 1710000000000
}

WebSocket (Socket.io)

altinapi, gerçek zamanlı fiyat güncellemeleri için Socket.io kullanır. Bağlantı sırasında API key'inizi auth objesiyle gönderin.

// npm install socket.io-client
const { io } = require("socket.io-client");

const socket = io("https://altinapi.com", {
  auth: { api_key: "hapi_YOUR_KEY" }
});

socket.on("connect", () => {
  console.log("Bağlandı");
  // İsteğe bağlı: belirli sembollere subscribe
  socket.emit("subscribe", ["DOVIZ", "MADEN"]);
});

// Anlık snapshot (bağlantı anında gelir)
socket.on("prices:snapshot", (data) => {
  console.log("Snapshot:", data);
});

// Gerçek zamanlı güncellemeler
socket.on("prices:update", (update) => {
  console.log("Güncelleme:", update);
});

// Bağlantı durumu
socket.on("data:stale", () => console.log("Veri güncellenmemiş"));
socket.on("data:live", () => console.log("Veri canlı"));

# pip install "python-socketio[client]"
import socketio

sio = socketio.Client()

@sio.event
def connect():
    print("Bağlandı")
    sio.emit("subscribe", ["DOVIZ"])

@sio.on("prices:update")
def on_update(data):
    print("Güncelleme:", data)

@sio.on("prices:snapshot")
def on_snapshot(data):
    print("Snapshot:", data)

sio.connect(
    "https://altinapi.com",
    auth={"api_key": "hapi_YOUR_KEY"}
)
sio.wait()

// composer require elephox/socket-io-client
// Alternatif: REST API polling önerilir

// REST ile basit kullanım:
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://altinapi.com/api/v1/prices");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: hapi_YOUR_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

WebSocket Events

İstemciden → Sunucuya

Sunucudan → İstemciye

Price Nesnesi

interface Price {
  symbol: string;      // örn: "USDTRY", "ALTIN"
  category: string;    // "DOVIZ" | "MADEN" | "PARITE" | "GRAM ALTIN" | "SARRAFIYE"
  bid: number;         // Alış fiyatı
  ask: number;         // Satış fiyatı
  timestamp: number;   // Unix timestamp (ms)
}

Sembol Listesi

Toplam 66 sembol, 5 kategori. Semboller büyük/küçük harf duyarsızdır.

Maden (MADEN) — 19 sembol

Gram Altın (GRAM ALTIN) — 5 sembol

Sarrafiye (SARRAFIYE) — 15 sembol

Döviz (DOVIZ) — 16 sembol

Parite (PARITE) — 11 sembol

Hata Kodları

{
  "error": "Açıklayıcı hata mesajı"
}