Mety Signal API

# 1) Algonu kaydet (bir kez)
curl -X POST https://signal.mety.dev/v1/algos \
  -H "X-Mety-Key: pk_test_..." -H "Content-Type: application/json" \
  -d '{"algo_id":"acme-trend-ai","name":"Acme Trend","timeframe":"1h",
       "description":{"tr":"Donchian kırılımı + hacim teyidi","en":"Donchian breakout + volume"}}'

# 2) Sinyal gönder (imzalı)
BODY='{"algo_id":"acme-trend-ai","signal_id":"BTC-LONG-20260923-01","pair":"BTCUSDT",
  "side":"LONG","issued_at":"2026-09-23T17:55:00Z","entry":{"type":"ZONE","low":62450,"high":62780},
  "sl":61720,"tp":[{"price":63150,"close_pct":40},{"price":63850,"close_pct":30},
  {"price":64900,"close_pct":20},{"price":66200,"close_pct":10}],
  "leverage":15,"margin":"ISOLATED","be_after":"TP1","valid_until":"2026-09-24T00:00:00Z"}'
TS=$(date +%s)
SIG=$(printf "%s.%s" "$TS" "$BODY" | openssl dgst -sha256 -hmac "$METY_SECRET" -hex | awk '{print $2}')
curl -X POST https://signal.mety.dev/v1/signals \
  -H "X-Mety-Key: pk_test_..." -H "X-Mety-Timestamp: $TS" -H "X-Mety-Signature: $SIG" \
  -H "Content-Type: application/json" -d "$BODY"

# 3) Karneni oku
curl https://signal.mety.dev/v1/algos/acme-trend-ai/score -H "X-Mety-Key: pk_test_..."

import hmac, hashlib, json, time, requests

KEY, SECRET = "pk_live_...", "sk_live_..."
body = json.dumps({
  "algo_id": "acme-trend-ai",
  "signal_id": "BTC-LONG-20260923-01",
  "pair": "BTCUSDT", "side": "LONG",
  "issued_at": "2026-09-23T17:55:00Z",
  "entry": {"type": "ZONE", "low": 62450, "high": 62780},
  "sl": 61720, "tp": [{"price": 63150, "close_pct": 40}],
}, separators=(",", ":"))
ts  = str(int(time.time()))
sig = hmac.new(SECRET.encode(), f"{ts}.{body}".encode(),
               hashlib.sha256).hexdigest()
r = requests.post("https://signal.mety.dev/v1/signals",
  data=body, headers={"X-Mety-Key": KEY, "X-Mety-Timestamp": ts,
    "X-Mety-Signature": sig, "Content-Type": "application/json"})
print(r.status_code, r.json())

import crypto from "node:crypto";

const KEY = "pk_live_...", SECRET = "sk_live_...";
const body = JSON.stringify({
  algo_id: "acme-trend-ai",
  signal_id: "BTC-LONG-20260923-01",
  pair: "BTCUSDT", side: "LONG",
  issued_at: new Date().toISOString(),
  entry: { type: "MARKET" }, sl: 61720,
  tp: [{ price: 63150 }],
});
const ts  = Math.floor(Date.now() / 1000).toString();
const sig = crypto.createHmac("sha256", SECRET)
  .update(`${ts}.${body}`).digest("hex");
const res = await fetch(
  "https://signal.mety.dev/v1/signals",
  { method: "POST", body, headers: {
    "X-Mety-Key": KEY, "X-Mety-Timestamp": ts,
    "X-Mety-Signature": sig,
    "Content-Type": "application/json" } });
console.log(res.status, await res.json());

• ✓
  Sandbox önce. pk_test_ anahtarı aynı doğrulamadan geçer, hiçbir şey yürütülmez, anında geri bildirim verir. Uyum testini geçmeden canlı anahtar verilmez.
• ↻
  Anahtar döndürme. Panelden ikinci bir anahtar üretip eskisini 24 saat sonra kapatabilirsin; geçiş süresince ikisi de geçerlidir.
• !
  Secret bizde saklanmaz — yalnız türevi tutulur. Kaybedersen yenisini üretirsin, geri okunamaz.

"Yürütülmedi" senin hatan değildir: coin o an başka bir motorda kilitli olabilir, kullanıcının kasası dolu olabilir, paket tavanı engelleyebilir. Bu sinyaller karnende nötrdür — ne ödül ne ceza.

{ "algo_id": "acme-trend-ai",
  "seal": true,                      // mühür: bu aralık bir daha değiştirilemez
  "range": {"from": "2025-09-23T00:00:00Z", "to": "2026-09-23T00:00:00Z"},
  "signals": [ "… kanonik sinyaller, issued_at geçmişte …" ] }

• !
  Mühür kuralı. Bir aralık bir kez aktarılır ve kapanır. Sonradan sinyal eklemek, silmek ya da düzeltmek mümkün değildir — kaybedenleri ayıklayarak karne şişirmenin önü budur.
• ⏱
  Saat matrisi son 3 ayı okur. Otonom çekirdek "şu saatte hangi algo" derken yakın dönemin saat başarısına bakar; daha eski veri uzun pencere skorlarına (180g / 365g) girer.
• ≈
  Geçmiş tek başına yeterli değildir. Canlıya çıkış için ileriye dönük gölge dönemi de gerekir (bölüm 11). Geçmiş veri, gölge süresini kısaltmaz; güveni artırır.
• ✓
  Etiketlenir. Kullanıcıya gösterilen karnede geçmiş-aktarım ile canlı ölçüm ayrı satırlarda görünür. Karıştırmayız.

Kullanıcının günlük zarar kesicisi, drawdown yarı-boyutu ve sessiz-saat kapıları senin sinyallerinde de çalışır. Karnende bu yüzden "gönderilen" ile "yürütülen" sayısı farklı olur — normaldir.

// GET /v1/earnings?month=2026-09
{ "month": "2026-09", "status": "open",
  "tokens_attributed": 18420, "share_pct": 60, "tokens_earned": 11052,
  "sessions": 214, "users": 63,
  "by_algo": [{"algo_id":"acme-trend-ai","tokens_earned":11052}],
  "payout": {"state":"pending_month_close", "eta":"2026-10-05"} }

// 422 Unprocessable
{ "error": "validation_failed",
  "details": [
    {"field":"issued_at", "message":"zorunlu — ISO-8601, unix sn veya ms",
     "accepts":["created_at","date","timestamp","ts"]},
    {"field":"sl", "message":"LONG sinyalde stop girişin yanlış tarafında (giriş 62615, sl 63000)"}
  ] }

Her webhook X-Mety-Signature taşır (aynı HMAC şeması). 2xx dönmeyen uç 5 kez, artan aralıkla yeniden denenir.

• 1
  İmza doğru. Ham gövde üzerinden HMAC; yeniden serileştirme yok.
• 2
  Idempotency çalışıyor. Aynı signal_id'yi iki kez göndermek çift kayıt üretmiyor.
• 3
  Güncelleme akışı var. Stop taşıma ve iptal PATCH ile gönderiliyor.
• 4
  Zaman doğru. issued_at gerçek üretim anı; sunucu saatinle senkronsun.
• 5
  Stop her sinyalde var (ya da bilinçli olarak bize bırakılıyor).
• 6
  Fee matematiği tutuyor. İşlem başına brüt beklentin round-trip fee'nin en az 3 katı.
• 7
  Geçmiş veri mühürlendi (aktaracaksan) ve tek seferde gönderildi.
• 8
  Webhook ucun 2xx dönüyor ve imzayı doğruluyor.

Takıldığın yerde dev@mety.dev — entegrasyon sorularına aynı gün dönüyoruz.