Coinlib API v1 เบต้า

บทนำ

คำติชมเกี่ยวกับ API ยินดีต้อนรับที่ info+api@coinlib.io แม้ว่านี่จะเป็นรุ่นเบต้า แต่เราคิดว่ามันจะเสถียรมาก นอกจากนี้ คำขอและการตอบสนองจะไม่เปลี่ยนแปลง อย่างน้อยก็ไม่มาก

ใบอนุญาต

คุณสามารถใช้ API ของเราภายใต้ใบอนุญาต Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0) โปรดตรวจสอบให้แน่ใจว่าคุณ ให้เครดิตเราด้วยลิงก์ หากคุณใช้ API ของเราบนเว็บไซต์หรือแอปของคุณ

การตรวจสอบ & ขีดจำกัดอัตรา

คุณต้องมีคีย์ API สำหรับการเรียก API ทั้งหมด รับบัญชีของคุณใน หน้าโปรไฟล์ ของคุณ (คุณต้องมีบัญชีและลงชื่อเข้าใช้เพื่อเข้าถึงหน้านี้)

ปลายทาง API ทั้งหมดอยู่ภายใต้ https://coinlib.io/api/v1 ใช้ GET เพื่อเข้าถึง API

เราให้คะแนนจำกัด API ต่อจุดสิ้นสุดและต่อชั่วโมง คำตอบทั้งหมดรวมถึงคำขอ ที่เหลือ ที่คุณทำได้จนถึงต้นชั่วโมงถัดไป

120 คำขอต่อชั่วโมงไปยัง /global
60 คำขอ/ชั่วโมง ไปยัง /coinlist
180 คำขอต่อชั่วโมงไปยัง /coin

คุณควรออกคำขอครั้งละหนึ่งคำขอ หากคุณพยายามทำคำขอแบบขนาน 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
        }