PIXCHARP ALTIN API · V1

Canlı altın fiyatı ürününüzde.

Harem kaynaklı altın, döviz ve değerli maden fiyatlarını tek API anahtarıyla uygulamanıza, web sitenize veya ekranlarınıza taşıyın.

CANLI FİYAT AKIŞIREST / JSONTEK ANAHTARHAREM KAYNAKLI

İlk isteği gönder Planları incele

Base URLhttps://api.pixcharp.com/v1

REST ve JSON

Mobil, web ve büyük ekranlar için sade HTTP çağrıları.

Tek anahtar

Her müşteri kendi anahtarı ve kotasıyla izole edilir.

Kota görünür

Rate limit ve aylık kullanım header'larda geri döner.

Güvenli sınır

Harem WebSocket'i müşteriye açılmaz, snapshot sunulur.

Başlangıç

İlk çağrı dört kısa adımda.

Bu akış, satın alma sonrası verilen API anahtarıyla ilk fiyat snapshot'ını almanız için yeterlidir.

Anahtarı al

Planınız etkinleştirildiğinde müşteri panelindeki anahtar üretim ekranını açın.

Header'ı ekle

X-API-Key veya Authorization: Bearer seçeneklerinden birini kullanın.

İsteği gönder

GET /v1/prices tüm güncel sembolleri tek JSON response içinde döndürür.

Kotanı takip et

Rate limit ve aylık kota kalanını her başarılı yanıttaki header'lardan okuyun.

curl -sS https://api.pixcharp.com/v1/prices \
  -H 'X-API-Key: pxa_live_...'

Anahtar yalnızca bir kez gösterilir

Ham secret, üretildiği yanıtta görünür. Güvenli bir parola kasasına kaydedin. Kaybolursa mevcut anahtarı iptal edip yeni bir key üretin.

Güvenlik

Kimlik doğrulama sade, sınırlar nettir.

Her dış API çağrısı aktif bir müşteri anahtarıyla yetkilendirilir. Anahtarlar log'lara ham olarak yazılmaz.

Önerilen header

Sunucu tarafı uygulamalarda anahtarı ortam değişkeninden okuyun.

X-API-Key: pxa_live_...

Bearer alternatifi

SDK veya mevcut auth katmanınız Bearer kullanıyorsa aynı anahtarı taşıyabilirsiniz.

Authorization: Bearer pxa_live_...

API anahtarını mobil uygulamanın içine gömmeyin. Mobil istemci için kendi backend'iniz üzerinden proxy kullanın.

const response = await fetch("https://api.pixcharp.com/v1/prices", {
  headers: { "X-API-Key": process.env.PIXCHARP_API_KEY },
});

if (!response.ok) {
  throw new Error(`Pixcharp Altın API: ${response.status}`);
}

const payload = await response.json();
console.log(payload.data);

import os
import requests

response = requests.get(
    "https://api.pixcharp.com/v1/prices",
    headers={"X-API-Key": os.environ["PIXCHARP_API_KEY"]},
    timeout=10,
)
response.raise_for_status()
prices = response.json()["data"]

using System.Net.Http.Headers;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", apiKey);
var response = await client.GetAsync("https://api.pixcharp.com/v1/prices");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Referans

Endpoint'leri doğrudan kullanın.

API yalnızca okuma amaçlı fiyat snapshot'ı sunar. Dört uç aynı yetkilendirme ve kota sözleşmesini paylaşır.

GET/pricesTüm güncel fiyatlar GET/prices/{symbol}Tek sembol fiyatı GET/symbolsSembol listesi GET/statusAkış durumu

GET/v1/prices

Tüm güncel fiyatlar

Yetkiniz olan sembollerin alış ve satış değerlerini tek bir snapshot içinde verir. Fiyatlar arasında tutarlı bir asOfUtc zamanı bulunur.

curl -sS https://api.pixcharp.com/v1/prices \
  -H 'X-API-Key: pxa_live_...'

{
  "version": "v1",
  "asOfUtc": "2026-08-05T10:24:13Z",
  "source": "harem",
  "stale": false,
  "data": [
    {
      "symbol": "HAS",
      "alis": 6127.46,
      "satis": 6155.99,
      "kapanis": null,
      "acilis": null,
      "asOfUtc": "2026-08-05T10:24:13Z",
      "source": "harem",
      "stale": false
    }
  ]
}

GET/v1/prices/{symbol}

Tek sembol fiyatı

Tek bir sembol için daha küçük response alın. ALTIN, GRAMALTIN ve XAUUSD gibi bilinen alias'lar canonical koda çevrilir.

curl -sS https://api.pixcharp.com/v1/prices/HAS \
  -H 'Authorization: Bearer pxa_live_...'

Örnek: /v1/prices/HAS cevabında symbol değeri HAS olarak döner.

GET/v1/symbols

Sembol listesi

Snapshot içinde bulunan canonical sembolleri keşfedin.

curl -sS https://api.pixcharp.com/v1/symbols \
  -H 'X-API-Key: pxa_live_...'

GET/v1/status

Akış durumu

Feed'in hazır olup olmadığını ve verinin bayatlık durumunu kontrol edin.

curl -sS https://api.pixcharp.com/v1/status \
  -H 'X-API-Key: pxa_live_...'

{
  "status": "ok",
  "version": "v1",
  "symbolCount": 18,
  "lastPriceUpdateUtc": "2026-08-05T10:24:13Z",
  "stale": false,
  "source": "harem"
}

Veri modeli

Yanıtı güvenle parse edin.

Fiyat response'u, ekranda göstermek için gereken değerleri ve snapshot'ın tazeliğini birlikte taşır.

{
  "version": "v1",
  "asOfUtc": "2026-08-05T10:24:13Z",
  "source": "harem",
  "stale": false,
  "data": [
    {
      "symbol": "HAS",
      "alis": 6127.46,
      "satis": 6155.99,
      "kapanis": null,
      "acilis": null,
      "asOfUtc": "2026-08-05T10:24:13Z",
      "source": "harem",
      "stale": false
    }
  ]
}

symbolstring

Canonical sembol kodu. Örnek: HAS veya GRAM_ALTIN.

alisnumber

Alış fiyatı. Türk lirası cinsinden sayısal değer.

satisnumber

Satış fiyatı. Türk lirası cinsinden sayısal değer.

kapanisnumber | null

Kapanış değeri upstream tarafından gelmezse null olabilir.

acilisnumber | null

Açılış değeri upstream tarafından gelmezse null olabilir.

asOfUtcISO 8601

Bu satırın fiyat snapshot'ına alındığı UTC zamanı.

sourcestring

Verinin upstream kaynağı. Bu sürümde harem.

staleboolean

Snapshot, tanımlı bayatlık süresini geçtiyse true.

Operasyon

Hataları ve limitleri önceden yönetin.

HTTP status kodunu ve title alanını birlikte kontrol edin. 429 cevaplarında Retry-After değerine uyun.

401api_key_required

Kimlik doğrulama header'ı yok.

401invalid_api_key

Anahtar bulunamadı veya geçersiz.

403revoked_api_key

Anahtar iptal edilmiş.

403inactive_client

Müşteri pasif veya süresi dolmuş.

404unknown_symbol

İstenen sembol snapshot içinde yok.

429rate_limit_exceeded

Dakikalık istek penceresi doldu.

429monthly_quota_exceeded

Aylık istek kotası doldu.

503price_feed_empty

İlk canlı fiyat snapshot'ı henüz oluşmadı.

Her cevapta kota sinyali

Başarılı ve limit cevaplarında mümkün olduğunda aşağıdaki header'lar bulunur. Aylık dönem UTC ayının ilk günü başlar.

X-API-Version: 1
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-Quota-Limit: 100000
X-Quota-Used: 42
X-Quota-Remaining: 99958

Kota seçenekleri

İhtiyacınıza göre ölçekleyin.

Plan limitleri varsayılan değerlerdir. Müşteri hesabı açılırken işletmenize göre farklılaştırılabilir.

PlanAylık istekİstek / dakikaWebSocket

Demodemo

1.00050

Başlangıçstarter

100.000300

Profesyonelpro

500.0001205

İşletmebusiness

2.000.00030010

Bu sürümde müşteriye Harem WebSocket bağlantısı açılmaz. WebSocket sütunu plan bilgisidir; dış tüketim REST snapshot ile yapılır.

Yayına alma

Üretimde sakin çalışması için.

İlk entegrasyonda bu kontrolleri uygulayın. Mobil uygulamalar için mevcut Railway adresi değişmez.

Snapshot ve bayatlık

stale: true geldiğinde veriyi hemen silmek yerine ekranda son güncelleme zamanını gösterin. Gerekirse yenileme isteğini geciktirin.

İzleme

/v1/status ile uygulama açılışında feed durumunu kontrol edin. 503 durumunu kısa bir backoff ile tekrar deneyin.

Destek ve anahtar yenileme

Anahtar kaybolduğunda eskisini iptal edip yeni key üretin. Destek talebinde müşteri adı ve key prefix bilgisini paylaşın, ham secret'ı değil.

Yayınlama kontrolü

Entegrasyonu gerçek müşteriye açmadan önce şu sırayı izleyin:

/health/live ve /health/ready yanıtlarını doğrulayın.
Demo anahtarıyla /v1/status ve /v1/prices çağrısı yapın.
429, 503 ve stale durumları için ekranda anlaşılır bir yedek durum oluşturun.
API anahtarını yalnızca sunucu ortam değişkeninde saklayın.

Hazır olduğunuzda

İlk entegrasyonunuzu birlikte netleştirelim.

Demo, plan ve müşteri hesabı için Pixcharp ekibine ulaşın. Teknik sorularınızı da aynı kanaldan iletebilirsiniz.

Erişim talep et Ürün sayfasını gör