ابنِ · EXPANSION API

الشبكة بأكملها، خلف API REST واحدة.

EXPANSION هي سطح API RESTful لبلوكشين Bantu. كل حساب، كل دفتر، كل معاملة، كل عملية، كل أصل — قابل للقراءة في ثوانٍ، قابل للبث في الوقت الفعلي. لا مصادقة مطلوبة للقراءات.

عنوان URL الأساسي لـmainnet

https://expansion.bantu.network

حركة الإنتاج. القيمة الحقيقية تتدفق هنا. استخدمه للتكاملات الحية.

عنوان URL الأساسي لـtestnet

https://expansion-testnet.bantu.network

testnet مجاني للتطوير. يزوّدك Friendbot بـXBN-test.

//الموارد

كل نقطة نهاية، منظَّمة حسب المورد.

الحسابات

استعلم عن حالة الحساب، الأرصدة، الموقّعين، trustlines، رقم التسلسل، النطاق الرئيسي.

GET /accounts/{account_id}
GET /accounts/{account_id}/transactions
GET /accounts/{account_id}/operations
GET /accounts/{account_id}/payments
GET /accounts/{account_id}/effects
GET /accounts/{account_id}/offers
GET /accounts/{account_id}/trades

الدفاتر

اقرأ الدفاتر المنجَزة (الكتل). رقم التسلسل، وقت الإغلاق، إجمالي المعاملات، إجمالي العملات، الرسوم الأساسية.

GET /ledgers
GET /ledgers/{sequence}
GET /ledgers/{sequence}/transactions
GET /ledgers/{sequence}/operations
GET /ledgers/{sequence}/payments
GET /ledgers/{sequence}/effects

المعاملات

افحص أو قدّم المعاملات. كل معاملة هي قائمة عمليات، موقَّعة من الحساب المصدر.

GET /transactions
GET /transactions/{tx_hash}
POST /transactions   (submit a signed envelope)
GET /transactions/{tx_hash}/operations
GET /transactions/{tx_hash}/effects

العمليات

أحداث دفترية دقيقة — مدفوعات، إصدار أصول، إعداد multisig، تغييرات trustline، مدفوعات المسار، إلخ.

GET /operations
GET /operations/{op_id}
GET /operations/{op_id}/effects

المدفوعات

عمليات من نوع الدفع تحديداً (مجموعة فرعية من العمليات). مفيدة لتاريخ المحفظة وتكامل التجار.

GET /payments

الأصول

كل أصل مُصدَر على السلسلة — الرمز، المُصدِر، العرض، الحاملون. دليل كل رمز على Bantu.

GET /assets
GET /assets?asset_code={CODE}
GET /assets?asset_issuer={G_ADDRESS}

دفتر الأوامر & الصفقات

DEX المدمج. افحص العروض/الطلبات لأي زوج أصول، استعلم عن تاريخ الصفقات.

GET /order_book?selling_asset_type=...&buying_asset_type=...
GET /trades
GET /offers/{offer_id}

الآثار

كل تغيير في الحالة كتدفق مسطّح — حساب أُنشئ، رصيد تغيّر، trustline حُدِّثت، موقّع أُضيف.

GET /effects
GET /effects?account_id=...

البث (SSE)

تدعم معظم نقاط نهاية القراءة Server-Sent Events للاشتراكات في الوقت الفعلي. أضف `Accept: text/event-stream`.

GET /transactions   Accept: text/event-stream
GET /ledgers        Accept: text/event-stream
GET /effects        Accept: text/event-stream

الترقيم، المعاملات الشائعة.

cursor

string

paging_token لآخر سجل من الصفحة السابقة. احذفه للصفحة الأولى.

order

asc | desc

اتجاه الفرز. الافتراضي asc.

limit

1–200

سجلات لكل صفحة. الافتراضي 10.

جرّب نداءً حياً — بلا مصادقة، بلا إعداد، الصق هذا في طرفيتك.

افتح Laboratory →GitHub →