Coinlib API v1 BETA

Introducere

Feedback-ul despre API este binevenit la info+api@coinlib.io. Deși aceasta este o versiune BETA, credem că va fi foarte stabil. În plus, cererile și răspunsurile nu se vor schimba, cel puțin nu foarte mult.

Licență

Puteți utiliza API-ul nostru sub o licență Creative Commons Atribuire-NonComercial 3.0 Unported (CC BY-NC 3.0). Asigurați-vă că ne creditați cu un link dacă utilizați API-ul nostru pe site-ul sau aplicația dvs.

Autentificare & limitele ratei

Aveți nevoie de o cheie API pentru toate apelurile API. Obțineți-l pe pagina de profil (trebuie să aveți un cont și să fiți autentificat pentru a accesa această pagină).

Toate punctele finale API sunt sub https://coinlib.io/api/v1. Utilizați GET pentru a accesa API-ul.

Evaluăm limităm API-ul pe punct final și pe oră. Toate răspunsurile includ solicitările rămase pe care le puteți face până la începutul orei următoare.

Ar trebui să emiteți întotdeauna o solicitare la un moment dat, dacă încercați să faceți solicitări paralele, un 429 va fi returnat. În cele din urmă, nu utilizați mai multe chei API.

Răspunsuri

Răspunsurile sunt în JSON. Numerele întregi (număr de monede, rang, marcaje temporale) sunt returnate ca numere întregi. Numerele zecimale sunt returnate ca șiruri de caractere, folosind un . ca punct zecimal și având până la 10 cifre de precizie.

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

Puncte finale


Statistici ale pieței globale

Punct final:
/global

Parametrii necesari:
key: API key

Parametri opționali:
pref: simbol de utilizat pentru prețuri și alte valori de piață. Implicit este USD.

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

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

Lista de monede

Punct final:
/coinlist

Parametrii necesari:
key: cheie API

Parametri opționali:
pref: simbol de utilizat pentru prețuri și alte valori de piață. Implicit este USD.
page: întreg, începând de la 1. Deocamdată returnăm 100 de rezultate pe pagină, dar acest lucru se poate schimba fără avertisment.
order: Exemplu:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

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

Informații despre monede

Punct final:
/coin

Parametrii necesari:
key: cheie API
symbol: simbol monedă unică sau o listă de simboluri separate prin virgulă

Parametri opționali:
pref: simbol de utilizat pentru prețuri și alte valori de piață. Implicit este USD.

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

Rezultat: 
        {
            "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
        }
Note:
symbol: Întotdeauna unic.
show_symbol: Simbolul pe care îl folosește moneda. Unele monede folosesc același simbol ca și alte monede.
total_volume_24h: Volumul total pentru toate piețele la care participă această monedă convertit în dvs pref valută.
markets: Afișăm primele 3 perechi pentru moneda selectată. Dacă moneda dvs. pref este tranzacționată, atunci aceasta este întotdeauna inclusă mai întâi.
exchanges: Primele 3 schimburi de volum pentru pereche.

Avansat:
Puteți obține informații pentru până la 10 monede cu un singur apel. Fiecare monedă este socotită din cota dvs. Dați o listă de simboluri separate prin virgulă, de exemplu:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Rezultatul în acest caz arată astfel: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }