ID ile OTC Emir Kuralı Güncelle

Var olan bir OTC emir kuralını değiştirir. Göndermediğiniz alanlar mevcut değerlerini korur; tek bir istisnayla: token_id her zaman yazılır, bu yüzden onu göndermemek (ya da null göndermek) kuralı düğüm geneli bir kurala çevirir. Kuralın o tokenla sınırlı kalması için token_id değerini yeniden gönderin. Kuralın düğümü (tokenla sınırlı kuralda tokenın düğümü de) API anahtarınızın düğüm alt ağacında olmalıdır. Kuralların nasıl uygulandığı OTC Emir Kuralı Oluştur sayfasında anlatılır.

rule_type değiştiğinde, yeni tipe ait olmayan eşikler gövdedeki eşikler uygulanmadan önce temizlenir: 2'ye (yüzde) geçiş above_amount / below_amount alanlarını, 3'e (mutlak) geçiş above_percent / below_percent alanlarını, 1'e (koşulsuz) geçiş ise dördünü birden temizler.

Gerekli izin: otc-order-rule:upsert

İstek

PUT /v2/admin/otc-order-rules/{rule_id}

Parametreler

Ad	Tip	Konum	Açıklama
rule_id	string	path	Zorunlu. Kural ID'si (24 karakter hex)

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
token_id	string veya null	Hayır	Kuralın sınırlandığı token. Her zaman yazılır: düğüm geneli kural için göndermeyin ya da null gönderin
node_id	string	Hayır	Kuralı bu düğüme taşır
name	string	Hayır	Kural adı
side	integer	Hayır	1 her iki taraf, 2 alış, 3 satış
rule_type	integer	Hayır	1 koşulsuz, 2 yüzde, 3 mutlak
status	integer	Hayır	1 pasif, 2 aktif
match_action	integer	Hayır	1 kabul, 2 ret. 0, 1 olarak saklanır
above_percent	string	Hayır	Yüzde kuralı: kabul edilen en yüksek fiyat, tokenın fiyatının üzerinde yüzde olarak. "0" ile "100" arası, en fazla bir ondalık
below_percent	string	Hayır	Yüzde kuralı: kabul edilen en düşük fiyat, tokenın fiyatının altında yüzde olarak. "0" ile "100" arası, en fazla bir ondalık
above_amount	string	Hayır	Mutlak kural: kabul edilen en yüksek fiyat, tokenın fiyatının üzerinde tutar olarak (ondalık string)
below_amount	string	Hayır	Mutlak kural: kabul edilen en düşük fiyat, tokenın fiyatının altında tutar olarak (ondalık string)
min_offer_quantity	integer	Hayır	Eşleşen en küçük teklif miktarı
max_offer_quantity	integer	Hayır	Eşleşen en büyük teklif miktarı
priority	integer	Hayır	Düşük değerler önce denenir
valid_from	string	Hayır	Geçerlilik penceresinin başlangıcı (RFC 3339)
valid_until	string	Hayır	Geçerlilik penceresinin sonu (RFC 3339)
consume_on_match	boolean	Hayır	Kuralla birlikte saklanır; şu an teklifler değerlendirilirken kullanılmaz

Bir eşik, miktar sınırı veya geçerlilik tarihi null gönderilerek temizlenemez; göndermemek değeri korur. Yüzdeler ve tutarlar ondalık string'dir; bkz. Tutarlar ve Yüzdeler.

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/otc-order-rules/6910a6ab5f635dd4dc251581' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "token_id": "6909ddb65b25a8f90960506a",
    "priority": 3,
    "above_percent": "11",
    "below_percent": "23"
  }'

Yanıt

{
  "id": "6910a6ab5f635dd4dc251581",
  "node_id": "6901350deb7ed8c1c38de4e9",
  "token_id": "6909ddb65b25a8f90960506a",
  "side": 1,
  "rule_type": 2,
  "match_action": 1,
  "above_percent": "11",
  "below_percent": "23",
  "min_offer_quantity": 1,
  "max_offer_quantity": 4,
  "consume_on_match": false,
  "priority": 3,
  "status": 2,
  "valid_from": "2025-11-12T01:04:12Z",
  "valid_until": "2025-11-19T01:04:24Z",
  "name": "Example Rule",
  "created_by": "000000000000000000000000",
  "created_at": "2025-11-09T14:35:23.19Z",
  "updated_at": "2025-11-10T09:04:47.951Z",
  "is_api": true
}

Yanıt Alanları

Güncellenen kural, OTC Emir Kurallarını Listele satırlarıyla aynı alanlarla.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. Bu ID'ye sahip kural yoksa (rule not found) ve hatalı biçimli yüzde ya da tutarda da döner
400	10016	rule_id 24 karakterlik bir hex ID değil
400	10001 (domain 2)	Kuralın düğümü bulunamadı
400	10001 (domain 5)	Kuralın tokenı bulunamadı
403	10005 (domain 2)	Kuralın düğümü ya da tokenının düğümü, API anahtarınızın düğüm alt ağacının dışında
500	10000	Beklenmeyen sunucu hatası

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.