Coinlib API v1 BETA

Intro

Feedback på API:et är välkommen på info+api@coinlib.io. Även om detta är en BETA vi tror att det kommer att vara mycket stabil. Dessutom kommer förfrågningar och svar inte förändras, åtminstone inte så mycket.

Licens

Du kan använda vårt API under en Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0) licens. Se till att du krediterar oss med en länk om du använder vårt API på din webbplats eller app.

Autentisering & hastighetsbegränsningar

Du behöver en API-nyckel för alla API-anrop. Få din i din profilsida (du måste ha ett konto och vara inloggad för att komma åt den här sidan).

Alla API-slutpunkter är under https://coinlib.io/api/v1 . Använd GET för att komma åt API: et.

Vi betygsätter begränsa API per slutpunkt och per timme. Alla svar inkluderar de remaining förfrågningar du kan göra fram till början av nästa timme.

Du bör alltid utfärda en begäran i taget, om du försöker göra parallella förfrågningar en 429 kommer att returneras. Slutligen inte använda flera API-nycklar.

Svar

Svaren finns i JSON . Heltal (antal mynt, rang, tidsstämplar) returneras som heltal. Decimaltal returneras som strängar, med en decimal och med . upp till 10 precisionssiffror.

Exempel på fel: 
        {
            "error": "Unknown pref symbol.",
            "remaining": 53
        }

Endpoints


Global marknadsstatistik

Slutpunkt:
/global

Krävs params:
key: API key

Params som tillval:
pref: symbol att använda för priser och andra marknadsvärden. Standard är USD.

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

Mynt lista

Slutpunkt:
/coinlist

Krävs params:
key: API-nyckel

Params som tillval:
pref: symbol att använda för priser och andra marknadsvärden. Standard är USD.
page: heltal, med början från 1. För nu återvänder vi 100 resultat per sida, men detta kan ändras utan förvarning.
order: Exempel:
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

Slutpunkt:
/coin

Krävs params:
key: API-nyckel
symbol: enstaka myntsymbol eller ett kommatecken åtskilda lista med symboler

Params som tillval:
pref: symbol att använda för priser och andra marknadsvärden. Standard är USD.

Exempel:
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
        }
Anteckningar:
symbol: Alltid unik.
show_symbol: Symbolen myntet använder. Vissa mynt använder samma symbol som andra mynt.
total_volume_24h: Den totala volymen för alla marknader detta mynt deltar konverteras i din pref valuta.
markets: Vi visar de 3 bästa paren för det utvalda myntet. Om din pref valuta handlas då det alltid ingår först.
exchanges: De 3 bästa börserna i volym för paret.

Avancerade:
Du kan få info för upp till 10 mynt med ett enda samtal. Varje mynt räknas mot din kvot. Ge ett kommat separeras lista över symboler ie:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Resultat i det här fallet ser ut: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }