Coinlib API v1 BÉTA

Intro

Az API-val kapcsolatos visszajelzéseket a következő címre várjuk: info+api@coinlib.io. Bár ez egy BÉTA, úgy gondoljuk, hogy nagyon stabil lesz. Ráadásul a kérések és válaszok nem változnak, legalábbis nem nagyon.

Engedély

API-nkat Creative Commons Nevezd meg, nem kereskedelmi célú 3.0 Unported (CC BY-NC 3.0) licenc alatt használhatod. Kérjük, győződjön meg arról, hogy hitelesít meg minket egy linkkel, ha az API-nkat használja webhelyén vagy alkalmazásában.

Hitelesítés & díjhatárok

Minden API-híváshoz API-kulcsra van szüksége. Szerezze be a sajátját a(z) profil oldal oldalon (az oldal eléréséhez fiókkal kell rendelkeznie, és be kell jelentkeznie).

Az összes API-végpont a https://coinlib.io/api/v1 alatt található. A GET használatával érheti el az API-t.

Az API-t végpontonként és óránként korlátozzuk. Minden válasz tartalmazza a fennmaradó kéréseket, amelyeket a következő óra elejéig megtehet.

120 kérés/óra a /global felé
60 kérés/óra a /coinlist-hoz
180 kérés/óra a /coin-hoz

Egyszerre mindig egy kérést kell kiadnia, ha párhuzamos kéréseket próbál végrehajtani, a rendszer 429-et küld vissza. Végül ne használjon több API-kulcsot.

Válaszok

A válaszok JSON formátumban találhatók. Az egész számok (érmék száma, rangsor, időbélyegek) egész számként jelennek meg. A tizedes számokat karakterláncként adja vissza, tizedesvesszőként egy .-t használva, és legfeljebb 10 pontosságú számjegyből állhat.

Példa hibára:

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

Végpontok

Globális piaci statisztikák

Végpont:
/global

Kötelező paraméterek:
key: API key

Választható paraméterek:
pref: szimbólum az árakhoz és egyéb piaci értékekhez. Az alapértelmezett érték USD.

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

Eredmény:

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

Éremlista

Végpont:
/coinlist

Kötelező paraméterek:
key: API kulcs

Választható paraméterek:
pref: szimbólum az árakhoz és egyéb piaci értékekhez. Az alapértelmezett érték USD.
page: egész szám, 1-től kezdve. Jelenleg oldalanként 100 találatot adunk vissza, de ez figyelmeztetés nélkül változhat.
order:

A rang (elsőtől utolsóig) használatra rank_asc
A rang (utolsótól az elsőig) használatra rank_desc
24 órás hangerőhöz (alacsonytól magasig) használható volume_asc
24 órás hangerőhöz (nagytól alacsonyig) használható volume_desc
Ár (alacsonytól magasig) felhasználásra price_asc
Ár (magastól alacsonyig) felhasználásra price_desc
A feltüntetett dátumhoz (a közelmúlttól a régebbiig) használat date_inserted_asc
A feltüntetett dátumhoz (régebbitől a legutóbbiig) használat date_inserted_desc

Példa:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

Eredmény:

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

Érmével kapcsolatos információk

Végpont:
/coin

Kötelező paraméterek:
key: API kulcs
symbol: egyetlen érme szimbólum vagy a szimbólumok vesszővel elválasztott listája

Választható paraméterek:
pref: szimbólum az árakhoz és egyéb piaci értékekhez. Az alapértelmezett érték USD.

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

Eredmény:

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

Megjegyzések:
symbol: Mindig egyedi.
show_symbol: Az érme által használt szimbólum. Egyes érmék ugyanazt a szimbólumot használják, mint más érmék.
total_volume_24h: Az összes piac teljes mennyisége, amelyen ez az érme részt vesz, átváltva az Ön értékére pref valuta.
markets: Mutatjuk a kiválasztott érme legjobb 3 párját. Ha a(z) pref pénznemével kereskednek, akkor mindig az szerepel először.
exchanges: A 3 legjobb csere a párra mennyiség szerint.

Fejlett:
Egy hívással akár 10 érméről is kaphat információt. Minden érme beleszámít a kvótába. Adja meg a szimbólumok vesszővel elválasztott listáját, pl.
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Az eredmény ebben az esetben így néz ki:

        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }