Coinlib API v1 BETA

Intro

Tilbakemelding om API er velkommen på info+api@coinlib.io. Selv om dette er en BETA tror vi den vil være veldig stabil. Dessuten vil ikke forespørslene og svarene endre seg, i hvert fall ikke særlig mye.

Tillatelse

Du kan bruke vår API under en Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0)-lisens. Sørg for at du krediterer oss med en lenke hvis du bruker API-en vår på nettstedet eller appen din.

Autentisering & takstgrenser

Du trenger en API-nøkkel for alle API-kall. Få din i profilside (du må ha en konto og være pålogget for å få tilgang til denne siden).

Alle API-endepunkter er under https://coinlib.io/api/v1. Bruk GET for å få tilgang til API.

Vi setter grenser for API per endepunkt og per time. Alle svar inkluderer de gjenværende forespørslene du kan gjøre til begynnelsen av neste time.

120 forespørsler/time til /global
60 forespørsler/time til /coinlist
180 forespørsler/time til /coin

Du bør alltid sende en forespørsel om gangen, hvis du prøver å gjøre parallelle forespørsler vil en 429 bli returnert. Til slutt ikke bruk flere API-nøkler.

Svar

Svarene er i JSON. Hele tall (antall mynter, rangering, tidsstempler) returneres som heltall. Desimaltall returneres som strenger ved å bruke en . som et desimaltegn og med opptil 10 presisjonssiffer.

Feileksempel:

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

Endepunkter

Global markedsstatistikk

Endepunkt:
/global

Nødvendige parametere:
key: API key

Valgfrie parametere:
pref: symbol for å bruke for priser og andre markedsverdier. Standard er USD.

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

Resultat:

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

Myntliste

Endepunkt:
/coinlist

Nødvendige parametere:
key: API-nøkkel

Valgfrie parametere:
pref: symbol for å bruke for priser og andre markedsverdier. Standard er USD.
page: heltall, fra 1. Foreløpig returnerer vi 100 resultater per side, men dette kan endres uten forvarsel.
order:

For rangering (første til siste) bruk rank_asc
For rangering (siste til første) bruk rank_desc
For volum 24 timer (lavt til høyt) bruk volume_asc
For volum 24 timer (høy til lav) bruk volume_desc
For pris (lav til høy) bruk price_asc
For pris (høy til lav) bruk price_desc
For dato oppført (nylig til eldre) bruk date_inserted_asc
For dato oppført (eldre til nyere) bruk date_inserted_desc

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

Resultat:

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

Mynt info

Endepunkt:
/coin

Nødvendige parametere:
key: API-nøkkel
symbol: enkelt myntsymbol eller en kommadelt liste over symboler

Valgfrie parametere:
pref: symbol for å bruke for priser og andre markedsverdier. Standard er USD.

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

Resultat:

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

Merknader:
symbol: Alltid unik.
show_symbol: Symbolet mynten bruker. Noen mynter bruker samme symbol som andre mynter.
total_volume_24h: Det totale volumet for alle markeder denne mynten deltar konvertert i din pref valuta.
markets: Vi viser de 3 beste parene for den valgte mynten. Hvis pref-valutaen din handles, er den alltid inkludert først.
exchanges: Topp 3 bytter etter volum for paret.

Avansert:
Du kan få informasjon for opptil 10 mynter med en enkelt samtale. Hver mynt telles mot kvoten din. Gi en kommadelt liste over symboler, dvs.:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Resultatet i dette tilfellet ser slik ut:

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