Coinlib API v1 BETA

Johdanto

Sovellusliittymää koskeva palaute on tervetullut osoitteeseen info+api@coinlib.io. Vaikka tämä on BETA, uskomme sen olevan erittäin vakaa. Lisäksi pyynnöt ja vastaukset eivät muutu, ainakaan kovin paljon.

Lisenssi

Voit käyttää sovellusliittymäämme Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0) -lisenssillä. Varmista, että hyvität meille linkin, jos käytät sovellusliittymäämme verkkosivustollasi tai sovelluksessasi.

Todennus & hintarajoituksia

Tarvitset API-avaimen kaikkia API-kutsuja varten. Hanki omasi profiilisivu (sinulla on oltava tili ja kirjaudut sisään päästäksesi tälle sivulle).

Kaikki API-päätepisteet ovat kohdassa https://coinlib.io/api/v1. Käytä sovellusliittymää GET-komennon avulla.

Arvioimme API-rajan päätepistettä ja tuntia kohti. Kaikki vastaukset sisältävät jäljellä olevat-pyynnöt, jotka voit tehdä seuraavan tunnin alkuun asti.

120 pyyntöä tunnissa osoitteeseen /global
60 pyyntöä/tunti kohteeseen /coinlist
180 pyyntöä tunnissa osoitteeseen /coin

Sinun tulee aina lähettää yksi pyyntö kerrallaan, jos yrität tehdä rinnakkaisia pyyntöjä, palautetaan 429. Älä lopuksi käytä useita API-avaimia.

Vastaukset

Vastaukset ovat JSON -muodossa. Kokonaisluvut (kolikoiden määrä, sijoitus, aikaleimat) palautetaan kokonaislukuina. Desimaaliluvut palautetaan merkkijonoina käyttäen .-merkkiä desimaalipisteenä ja joissa on enintään 10 tarkkuutta.

Esimerkki virheestä:

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

Päätepisteet

Maailmanmarkkinatilastot

Päätepiste:
/global

Vaaditut parametrit:
key: API key

Valinnaiset parametrit:
pref: symboli hintojen ja muiden markkina-arvojen kuvaamiseen. Oletusarvo on USD.

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

Tulos:

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

Kolikkoluettelo

Päätepiste:
/coinlist

Vaaditut parametrit:
key: API-avain

Valinnaiset parametrit:
pref: symboli hintojen ja muiden markkina-arvojen kuvaamiseen. Oletusarvo on USD.
page: kokonaisluku, alkaen 1. Tällä hetkellä palautamme 100 tulosta per sivu, mutta tämä voi muuttua ilman varoitusta.
order:

Sijoitus (ensimmäisestä viimeiseen) käyttöön rank_asc
Sijoitus (viimeisestä ensimmäiseen) käyttöön rank_desc
24 tunnin tilavuuteen (pienestä korkeaan) käyttöön volume_asc
24h (korkeasta alhaiseen) käyttöön volume_desc
Hintaan (alhaalta korkeaan) käyttöön price_asc
Hintaan (korkeasta alhaiseen) käyttöön price_desc
Ilmoitettuun päivämäärään (äskettäisestä vanhempaan) käyttöön date_inserted_asc
Listattu päivämäärä (vanhemmasta viimeaikaiseen) käyttöön date_inserted_desc

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

Tulos:

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

Kolikon tiedot

Päätepiste:
/coin

Vaaditut parametrit:
key: API-avain
symbol: yksittäinen kolikon symboli tai pilkuilla erotettu symboliluettelo

Valinnaiset parametrit:
pref: symboli hintojen ja muiden markkina-arvojen kuvaamiseen. Oletusarvo on USD.

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

Tulos:

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

Huomautuksia:
symbol: Aina ainutlaatuinen.
show_symbol: Kolikon käyttämä symboli. Jotkut kolikot käyttävät samaa symbolia kuin muut kolikot.
total_volume_24h: Kaikkien tämän kolikon markkinoiden kokonaismäärä muutettuna sinun pref valuutta.
markets: Näytämme valitun kolikon 3 parasta paria. Jos valuutallasi pref käydään kauppaa, se sisällytetään aina ensin.
exchanges: Parin 3 parasta vaihtoa volyymin mukaan.

Pitkälle kehittynyt:
Voit saada tietoja jopa 10 kolikosta yhdellä puhelulla. Jokainen kolikko lasketaan kiintiösi mukaan. Anna pilkuilla eroteltu luettelo symboleista, esim.
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Tulos tässä tapauksessa näyttää tältä:

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