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.

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: 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
        }