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"[
{
"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" }
]
}
]| Alan | Anlamı |
|---|---|
asset | Varlık. |
available | Kullanı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_at | Varlığı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"[
{
"provider": "bvnk",
"asset": "EURC",
"network": "ETH",
"address": "0x8b1e5f0c2a9d47e3b6c1f08a5d2e9b7c4a6f3d10"
}
]Bir kayıt iki biçimden biridir:
| Biçim | Alanlar | Nasıl yatırılır |
|---|---|---|
| Zincir üstü | network, address, ağ gerektiriyorsa memo | Tam 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 havalesi | bank_details: Provider'ın kendi alan adları ve değerleri | Bu 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
- Varlığı talimatın söylediği gibi gönderirsiniz.
- 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.
- Tutar o Provider'daki
availabledeğerine eklenir vedeposit.receivedwebhook'u gönderilir:
{
"asset": "EURC",
"amount": "1000",
"received_at": "2026-11-12T09:55:12Z"
}- O Provider'da para bekleyen
accepteddurumundaki ö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:
{
"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.