Coinlib API v1 BETA

pengenalan

Maklum balas tentang API dialu-alukan di info+api@coinlib.io. Walaupun ini adalah BETA, kami fikir ia akan menjadi sangat stabil. Lebih-lebih lagi permintaan dan respons tidak akan berubah, sekurang-kurangnya tidak banyak.

Lesen

Anda boleh menggunakan API kami di bawah lesen Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Sila pastikan anda kreditkan kami dengan pautan jika anda menggunakan API kami di tapak web atau apl anda.

Pengesahan & had kadar

Anda memerlukan kunci API untuk semua panggilan API. Dapatkan milik anda dalam halaman profil anda (anda perlu mempunyai akaun dan log masuk untuk mengakses halaman ini).

Semua titik akhir API berada di bawah https://coinlib.io/api/v1. Gunakan GET untuk mengakses API.

Kami menilai had API setiap titik akhir dan setiap jam. Semua jawapan termasuk permintaan baki yang boleh anda lakukan sehingga permulaan jam berikutnya.

Anda harus sentiasa mengeluarkan satu permintaan pada satu masa, jika anda cuba melakukan permintaan selari, 429 akan dikembalikan. Akhir sekali jangan gunakan berbilang kunci API.

Jawapan

Respons ada dalam JSON. Nombor bulat (bilangan syiling, pangkat, cap masa) dikembalikan sebagai integer. Nombor perpuluhan dikembalikan sebagai rentetan, menggunakan . sebagai titik perpuluhan dan mempunyai sehingga 10 digit ketepatan.

Contoh ralat: 
        {
            "error": "Unknown pref symbol.",
            "remaining": 53
        }

Titik akhir


Statistik pasaran global

Titik akhir:
/global

Params yang diperlukan:
key: API key

Params pilihan:
pref: simbol untuk digunakan untuk harga dan nilai pasaran lain. Lalai ialah USD.

Contoh:
https://coinlib.io/api/v1/global?key=XXX&pref=EUR

Keputusan: 
        {
            "coins": 4329,
            "markets": 13648,
            "total_market_cap": "207058335320.66",
            "total_volume_24h": "10413469137.11",
            "last_updated_timestamp": 1528975469,
            "remaining": 540
        }

Senarai syiling

Titik akhir:
/coinlist

Params yang diperlukan:
key: kunci API

Params pilihan:
pref: simbol untuk digunakan untuk harga dan nilai pasaran lain. Lalai ialah USD.
page: integer, bermula dari 1. Buat masa ini kami mengembalikan 100 hasil setiap halaman, tetapi ini mungkin berubah tanpa amaran.
order:
  • Untuk kegunaan pangkat (pertama hingga terakhir). rank_asc
  • Untuk penggunaan pangkat (terakhir hingga pertama). rank_desc
  • Untuk penggunaan volum 24j (rendah ke tinggi). volume_asc
  • Untuk penggunaan volum 24j (tinggi ke rendah). volume_desc
  • Untuk kegunaan harga (rendah ke tinggi). price_asc
  • Untuk kegunaan harga (tinggi ke rendah). price_desc
  • Untuk tarikh yang disenaraikan (terbaru kepada yang lebih lama) gunakan date_inserted_asc
  • Untuk tarikh yang disenaraikan (lama hingga terkini) gunakan date_inserted_desc
Contoh:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

Keputusan: 
        {
            "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
        }

Maklumat syiling

Titik akhir:
/coin

Params yang diperlukan:
key: kunci API
symbol: simbol syiling tunggal atau senarai simbol yang dipisahkan koma

Params pilihan:
pref: simbol untuk digunakan untuk harga dan nilai pasaran lain. Lalai ialah USD.

Contoh:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC

Keputusan: 
        {
            "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
        }
Nota:
symbol: Sentiasa unik.
show_symbol: Simbol yang syiling gunakan. Sesetengah syiling menggunakan simbol yang sama seperti syiling lain.
total_volume_24h: Jumlah volum untuk semua pasaran yang disertai syiling ini ditukar dalam anda pref mata wang.
markets: Kami menunjukkan 3 pasangan teratas untuk syiling yang dipilih. Jika mata wang pref anda didagangkan maka ia sentiasa disertakan dahulu.
exchanges: 3 teratas bertukar mengikut volum untuk pasangan.

Lanjutan:
Anda boleh mendapatkan maklumat sehingga 10 syiling dengan satu panggilan. Setiap syiling dikira dengan kuota anda. Berikan senarai simbol yang dipisahkan koma iaitu:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Keputusan dalam kes ini kelihatan seperti: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }