Coinlib API v1 BTA

Intro

Feedback over de API is welkom op info+api@coinlib.io. Hoewel dit een BETA is, denken we dat het erg stabiel zal zijn. Bovendien zullen de verzoeken en reacties niet veranderen, althans niet veel.

Vergunning

U kunt onze API gebruiken onder een Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0) licentie. Zorg ervoor dat u ons een link geeft als u onze API op uw website of app gebruikt.

Authenticatie & snelheidslimieten

Voor alle API-aanroepen heb je een API-sleutel nodig. Zet de jouwe in je profiel pagina (je moet een account hebben en ingelogd zijn om toegang te krijgen tot deze pagina).

Alle API-eindpunten staan onder https://coinlib.io/api/v1. Gebruik GET om toegang te krijgen tot de API.

We beoordelen de API per endpoint en per uur. Alle reacties bevatten de resterende verzoeken die je kunt doen tot het begin van het volgende uur.

U moet altijd één verzoek tegelijk indienen, als u parallelle verzoeken probeert te doen, wordt een 429 geretourneerd. Gebruik tot slot niet meerdere API-sleutels.

Reacties

Reacties staan in JSON. Hele getallen (aantal munten, rang, tijdstempels) worden geretourneerd als gehele getallen. Decimale getallen worden geretourneerd als tekenreeksen, met een . als decimaalteken en met maximaal 10 precisiecijfers.

Voorbeeld van een fout: 
        {
            "error": "Unknown pref symbol.",
            "remaining": 53
        }

Eindpunten


Wereldwijde marktstatistieken

Eindpunt:
/global

Vereiste parameters:
key: API key

Optionele parameters:
pref: symbool voor prijzen en andere marktwaarden. Standaard is USD.

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

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

Muntenlijst

Eindpunt:
/coinlist

Vereiste parameters:
key: API sleutel

Optionele parameters:
pref: symbool voor prijzen en andere marktwaarden. Standaard is USD.
page: integer, beginnend bij 1. Voor nu geven we 100 resultaten per pagina, maar dit kan zonder waarschuwing veranderen.
order: Voorbeeld:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

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

Muntinformatie

Eindpunt:
/coin

Vereiste parameters:
key: API sleutel
symbol: enkel muntsymbool of een door komma's gescheiden lijst met symbolen

Optionele parameters:
pref: symbool voor prijzen en andere marktwaarden. Standaard is USD.

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

Resultaat: 
        {
            "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
        }
Opmerkingen:
symbol: Altijd uniek.
show_symbol: Het symbool dat de munt gebruikt. Sommige munten gebruiken hetzelfde symbool als andere munten.
total_volume_24h: Het totale volume voor alle markten waaraan deze munt deelneemt, omgezet in uw pref munteenheid.
markets: We tonen de top 3 paren voor de geselecteerde munt. Als uw pref valuta wordt verhandeld, wordt deze altijd als eerste opgenomen.
exchanges: De top 3 ruilt naar volume voor het paar.

Geavanceerd:
U kunt met een enkele oproep informatie krijgen voor maximaal 10 munten. Elke munt wordt geteld voor uw quotum. Geef een door komma's gescheiden lijst van symbolen, bijvoorbeeld:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Het resultaat ziet er in dit geval als volgt uit: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }