Coinlib API v1 BETA

Intro

Feedback om API er velkommen på info+api@coinlib.io. Selvom dette er en BETA, tror vi, at det vil være meget stabilt. Desuden vil anmodningerne og svarene ikke ændre sig, i hvert fald ikke ret meget.

Licens

Du kan bruge vores API under en Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0)-licens. Sørg for at kreditere os med et link, hvis du bruger vores API på dit websted eller din app.

Godkendelse & satsgrænser

Du skal bruge en API-nøgle til alle API-kald. Få din i din profilside (du skal have en konto og være logget ind for at få adgang til denne side).

Alle API-endepunkter er under https://coinlib.io/api/v1. Brug GET for at få adgang til API'en.

Vi sætter grænser for API'en pr. slutpunkt og pr. time. Alle svar inkluderer de resterende anmodninger, du kan gøre indtil begyndelsen af den næste time.

120 anmodninger/time til /global
60 anmodninger/time til /coinlist
180 anmodninger/time til /coin

Du bør altid udstede en anmodning ad gangen, hvis du forsøger at lave parallelle anmodninger, vil en 429 blive returneret. Brug endelig ikke flere API-nøgler.

Svar

Svar er i JSON. Hele tal (antal mønter, rang, tidsstempler) returneres som heltal. Decimaltal returneres som strenge ved at bruge en . som et decimaltegn og med op til 10 præcisionscifre.

Fejleksempel:

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

Slutpunkter

Globale markedsstatistikker

Slutpunkt:
/global

Nødvendige parametre:
key: API key

Valgfri parametre:
pref: symbol til brug for priser og andre markedsværdier. 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
        }

Møntliste

Slutpunkt:
/coinlist

Nødvendige parametre:
key: API nøgle

Valgfri parametre:
pref: symbol til brug for priser og andre markedsværdier. Standard er USD.
page: heltal, startende fra 1. Indtil videre returnerer vi 100 resultater pr. side, men dette kan ændre sig uden varsel.
order:

Til rang (først til sidst) brug rank_asc
Til rang (sidst til første) brug rank_desc
Til volumen 24 timer (lav til høj) brug volume_asc
Til volumen 24 timer (høj til lav) brug volume_desc
Til pris (lav til høj) brug price_asc
Til pris (høj til lav) brug price_desc
Til datolistet (nylig til ældre) brug date_inserted_asc
Til datolistet (ældre til nyere) brug 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
        }

Mønt info

Slutpunkt:
/coin

Nødvendige parametre:
key: API nøgle
symbol: enkelt møntsymbol eller en kommasepareret liste over symboler

Valgfri parametre:
pref: symbol til brug for priser og andre markedsværdier. 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
        }

Bemærkninger:
symbol: Altid unik.
show_symbol: Symbolet mønten bruger. Nogle mønter bruger det samme symbol som andre mønter.
total_volume_24h: Den samlede mængde for alle markeder denne mønt deltager konverteret i din pref betalingsmiddel.
markets: Vi viser de øverste 3 par for den valgte mønt. Hvis din pref valuta handles, er den altid inkluderet først.
exchanges: De 3 bedste udveksles efter volumen for parret.

Fremskreden:
Du kan få info for op til 10 mønter med et enkelt opkald. Hver mønt tælles med i din kvote. Angiv en kommasepareret liste over symboler, dvs.
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Resultatet i dette tilfælde ser sådan ud:

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