İçeriğe geç
Apex Settlement

Bakiyeler ve para yatırma

Ne tuttuğunuzu ve nerede tuttuğunuzu okuyun, bakiyenizi doğru Provider'da fonlayın ve yatırdığınız paranın gelişini görün.

Her ödeme bakiyenizden fonlanır. Bakiyeniz varlık bazında, bir varlığın içinde de Provider bazında tutulur: parayı tutan Provider, onu hangi rotaların gönderebileceğini belirler.

Bakiyelerinizi okuma

GET /v1/balances, customer:read iznini ister.

curl "$APEX_BASE_URL/v1/balances" \
  -H "Authorization: Bearer $APEX_API_KEY"
200 OK
[
  {
    "asset": "USDC",
    "available": "1500",
    "held": "0",
    "held_at": [
      { "provider": "zerohash", "available": "500", "held": "0" },
      { "provider": "bvnk", "available": "1000", "held": "0" }
    ]
  },
  {
    "asset": "USDT",
    "available": "9000",
    "held": "1000",
    "held_at": [
      { "provider": "zerohash", "available": "9000", "held": "1000" }
    ]
  }
]
AlanAnlamı
assetVarlık.
availableKullanılabilir: tüm Provider'lar genelinde şu an gönderebileceğiniz tutar.
heldÖdemeler için ayrılan: fonlanmış ama henüz bitmemiş ödemeler için kenara konan tutar. Ödeme tamamlandığında ya da iade edildiğinde serbest kalır.
held_atVarlığın bir kısmını tutan her Provider için aynı iki rakam. provider, GET /v1/deposit-instructions ve tekliflerin kullandığı anahtardır.

Bir varlığın available ve held değerleri, held_at kayıtlarının toplamıdır. Tüm tutarlar ondalık sayı metnidir.

Bakiye neden Provider'a göre bölünür

Her Provider, ona yatırdığınız parayı orada size ait bir hesapta tutar. Bu yüzden:

  • Yatırdığınız para, ulaştığı Provider'da bakiyenize eklenir.
  • Bir ödeme yalnızca tek bir Provider'dan gönderilir: rotasının başladığı Provider'dan.
  • Bir iade, paranın ayrıldığı Provider'a geri döner.

Para, Provider'lar arasında hiçbir zaman birleştirilmez. Bir Provider'da 500 USDC, diğerinde 1000 USDC tutuyorsanız tek bir ödemede en fazla 1000 USDC gönderebilirsiniz; o da yalnızca ikinci Provider'da başlayan bir rotayla.

Para yatırma talimatlarını alma

GET /v1/deposit-instructions?asset=, bir varlığı bakiyenize eklenecek şekilde nereye göndereceğinizi söyler. Hesabınızı onaylamış ve o varlıkta para yatırma kabul eden her Provider için bir kayıt gelir.

curl "$APEX_BASE_URL/v1/deposit-instructions?asset=EURC" \
  -H "Authorization: Bearer $APEX_API_KEY"
200 OK
[
  {
    "provider": "bvnk",
    "asset": "EURC",
    "network": "ETH",
    "address": "0x8b1e5f0c2a9d47e3b6c1f08a5d2e9b7c4a6f3d10"
  }
]

Bir kayıt iki biçimden biridir:

BiçimAlanlarNasıl yatırılır
Zincir üstünetwork, address, ağ gerektiriyorsa memoTam olarak asset varlığını network ağında address adresine gönderin. memo değerini ekleyin; eklemezseniz yatırdığınız tutar size yazılamaz.
Banka havalesibank_details: Provider'ın kendi alan adları ve değerleriBu bilgilerle, verildiği gibi bir banka havalesi yapın.

Değerler hiçbir zaman maskelenmez: olduğu gibi kopyalayın. Boş bir liste, Provider'larınızdan hiçbirinin o varlıkta para yatırma kabul etmediği anlamına gelir. Hatalı bir varlık kodu asset_invalid (422) döner.

Sandbox

Sandbox'ta para yatırma adresleri hiçbir gerçek ağda olmayan yer tutuculardır. Bu adreslere asla gerçek para göndermeyin; bunun yerine sandbox bakiyenize test parası eklemesi için hesap ekibinize yazın. USDC ve EURC bir Provider'a, USDT ve USDC başka bir Provider'a yatırılabilir. Henüz banka havalesiyle para yatırma yok. Bkz. Ortamlar.

Yatırdığınız para nasıl görünür

  1. Varlığı talimatın söylediği gibi gönderirsiniz.
  2. Provider para yatırmayı ve kaynağının doğrulandığını onaylar. Provider'ın doğrulamadığı bir para yatırma, doğrulanana kadar bakiyeye bir şey eklemez.
  3. Tutar o Provider'daki available değerine eklenir ve deposit.received webhook'u gönderilir:
deposit.received, data alanı
{
  "asset": "EURC",
  "amount": "1000",
  "received_at": "2026-11-12T09:55:12Z"
}
  1. O Provider'da para bekleyen accepted durumundaki ödemeler fonlanır; en eski önce.

Zarf ve imzası için bkz. Webhook'lar. Hesabınız askıdayken yatırılan para yine bakiyenize eklenir, ancak hesap yeniden aktif olana kadar hiçbir ödemeyi fonlamaz.

Başka bir Provider'daki bakiye

Gönderilecek tutarı tutuyor olduğunuz halde, o alıcıya giden rotaların başladığı bir Provider'da tutmuyorsanız teklif yanıtı funds_at_other_provider olur. Tom'un 1000 USDC'sinin tamamı, GBP alıcısına giden hiçbir rotanın başlamadığı bir Provider'da; 1000 USDC için teklif istiyor:

POST /v1/quotes, 201 Created
{
  "quote_set_id": "5d2a8f0c-1e6b-4b7a-9c3d-8f4e2a1b6c90",
  "quotes": [],
  "unavailable_reason": "funds_at_other_provider",
  "deposit_at": ["bvnk"],
  "server_time": "2026-11-12T10:00:00Z"
}

deposit_at değerini okuyun

Gönderilecek varlığı yatırdığınızda rota açılacak Provider'ları listeler. Bu nedenle geldiğinde hiçbir zaman boş değildir.

Talimatları alın

GET /v1/deposit-instructions?asset=USDC çağırın ve provider değeri deposit_at içinde olan kaydı alın.

Yatırın ve bekleyin

Tutarı oraya gönderin; deposit.received webhook'unu ya da GET /v1/balances yanıtındaki held_at içinde görünmesini bekleyin.

Yeniden teklif isteyin

Aynı gövdeyle POST /v1/quotes artık teklif döner.

Paranızı bir Provider'dan diğerine taşıyan bir çağrı yoktur.

Kendi banka hesabınıza çekme

Bankanıza çekmek, own_account türündeki alıcılarınızdan birine yapılan sıradan bir ödemedir. Hesabı kaydedin, uyum ekibi doğrulayana kadar bekleyin, sonra diğer alıcılar gibi teklif alıp ödeyin. Diğer müşterilerin size gönderdiği PKR gibi yerel para birimindeki bir bakiye, aynı ülke ve para birimindeki kendi hesabınıza çekilir. Bkz. Alıcılar ve Ödeme gönderme.

Sonraki adımlar

Bu sayfada