Coinlib API v1 BETA

مقدمة

نرحب بالتعليقات على واجهة برمجة التطبيقات على [email protected]. على الرغم من أن هذا إصدار تجريبي ، إلا أننا نعتقد أنه سيكون مستقرًا للغاية. علاوة على ذلك ، لن تتغير الطلبات والردود ، على الأقل ليس كثيرًا.

رخصة

يمكنك استخدام API الخاص بنا بموجب ترخيص Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). يرجى التأكد من اعتمادنا رابطًا إذا كنت تستخدم واجهة برمجة التطبيقات الخاصة بنا على موقعك على الويب أو تطبيقك.

المصادقة وأمبير. حدود معدل

أنت بحاجة إلى مفتاح API لجميع استدعاءات API. احصل على حسابك في الصفحة الشخصية (يجب أن يكون لديك حساب وتسجيل الدخول للوصول إلى هذه الصفحة).

جميع نقاط نهاية واجهة برمجة التطبيقات موجودة ضمن https://coinlib.io/api/v1 . استخدم GET للوصول إلى واجهة برمجة التطبيقات.

نحن نقيّد واجهة برمجة التطبيقات لكل نقطة نهاية وكل ساعة. تتضمن جميع الردود الطلبات المتبقية التي يمكنك تنفيذها حتى بداية الساعة التالية.

  • 120 طلب / ساعة إلى / global
  • 60 طلب / ساعة إلى / coinlist
  • 180 طلب / ساعة لعملة / عملة
يجب عليك دائمًا إصدار طلب واحد في كل مرة ، إذا حاولت القيام بطلبات موازية ، فسيتم إرجاع 429. أخيرًا ، لا تستخدم مفاتيح API متعددة.

استجابات

الردود في JSON . يتم إرجاع الأعداد الصحيحة (عدد العملات ، الترتيب ، الطوابع الزمنية) كأعداد صحيحة. يتم إرجاع الأرقام العشرية كسلاسل ، باستخدام . كنقطة عشرية وبها ما يصل إلى 10 أرقام دقة.

مثال على الخطأ: 
        {
            "error": "Unknown pref symbol.",
            "remaining": 53
        }

نقاط النهاية


احصائيات السوق العالمية

نقطة النهاية:
/global

المعلمات المطلوبة:
key: API key

معلمات اختيارية:
pref: رمز لاستخدامه في الأسعار وقيم السوق الأخرى. الافتراضي هو USD.

مثال:
https://coinlib.io/api/v1/global?key=XXX&pref=EUR

نتيجة: 
        {
            "coins": 4329,
            "markets": 13648,
            "total_market_cap": "207058335320.66",
            "total_volume_24h": "10413469137.11",
            "last_updated_timestamp": 1528975469,
            "remaining": 540
        }

قائمة العملات

نقطة النهاية:
/coinlist

المعلمات المطلوبة:
key: مفتاح API

معلمات اختيارية:
pref: رمز لاستخدامه في الأسعار وقيم السوق الأخرى. الافتراضي هو USD.
page: عدد صحيح ، يبدأ من 1. في الوقت الحالي نرجع 100 نتيجة لكل صفحة ، ولكن هذا قد يتغير دون سابق إنذار.
order:
  • للاستخدام في المرتبة (من الأول إلى الأخير) rank_asc
  • للاستخدام في المرتبة (من الأخير إلى الأول) rank_desc
  • لحجم 24 ساعة (منخفض إلى مرتفع) استخدم volume_asc
  • لحجم 24 ساعة (عالي إلى منخفض) استخدم volume_desc
  • بالنسبة للسعر (من الأقل إلى الأعلى) ، استخدم price_asc
  • بالنسبة للسعر (من الأعلى إلى الأقل) ، استخدم price_desc
  • للتاريخ المدرج (الأحدث إلى الأقدم) استخدم date_inserted_asc
  • للتاريخ المدرج (من الأقدم إلى الأحدث) الاستخدام date_inserted_desc
مثال:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

نتيجة: 
        {
            "coins": [
                {
                    "symbol": "ETH",
                    "show_symbol": "ETH",
                    "name": "Ethereum",
                    "rank": 2,
                    "price": "0.078420138035523",
                    "market_cap": "7847729.8474137",
                    "volume_24h": "260650.1638446",
                    "delta_24h": "5.91"
                },
                {...},
                {...},
            ],
            "last_updated_timestamp": 1565321123,
            "remaining": 84
        }

معلومات العملة

نقطة النهاية:
/coin

المعلمات المطلوبة:
key: مفتاح API
symbol: رمز عملة واحدة أو قائمة رموز مفصولة بفاصلة

معلمات اختيارية:
pref: رمز لاستخدامه في الأسعار وقيم السوق الأخرى. الافتراضي هو USD.

مثال:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC

نتيجة: 
        {
            "symbol": "BTC",
            "show_symbol": "BTC",
            "name": "Bitcoin",
            "rank": 1,
            "price": "5524.7112165586",
            "market_cap": "94433817003.39",
            "total_volume_24h": "6378793658.5432",
            "low_24h": "5324.2665427149",
            "high_24h": "5561.0068476948",
            "delta_1h": "0.81",
            "delta_24h": "0.68",
            "delta_7d": "-15.26",
            "delta_30d": "-25.26",
            "markets": [
                {
                    "symbol": "EUR",
                    "volume_24h": "123707000",
                    "price": "5524.7112165586",
                    "exchanges": [
                        {
                            "name": "Kraken",
                            "volume_24h": "50623900",
                            "price": "5520"
                        },
                        {
                            "name": "Bitfinex",
                            "volume_24h": "19314700",
                            "price": "5512.6"
                        },
                        {...}
                    ]
                },
                {...},
                {...}
            ],
            "last_updated_timestamp": 1528987416,
            "remaining": 1133
        }
ملحوظات:
symbol: دائما فريد.
show_symbol: الرمز الذي تستخدمه العملة. تستخدم بعض العملات نفس رمز العملات المعدنية الأخرى.
total_volume_24h: تم تحويل الحجم الإجمالي لجميع الأسواق التي تشارك فيها هذه العملة في حسابك pref عملة.
markets: نعرض أعلى 3 أزواج للعملة المختارة. إذا تم تداول عملتك pref ، فسيتم تضمينها دائمًا أولاً.
exchanges: أكبر 3 عمليات تبادل من حيث الحجم للزوج.

متقدم:
يمكنك الحصول على معلومات تصل إلى 10 عملات بمكالمة واحدة. يتم احتساب كل عملة من حصتك. قدم قائمة من الرموز مفصولة بفواصل ، على سبيل المثال:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
النتيجة في هذه الحالة تبدو كما يلي: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }