Coinlib API v1 BETA

Intro

Ang feedback sa API ay tinatanggap sa info+api@coinlib.io. Bagama't ito ay isang BETA sa tingin namin ito ay magiging napaka-stable. Bukod dito ang mga kahilingan at tugon ay hindi magbabago, hindi bababa sa hindi masyadong magkano.

Lisensya

Maaari mong gamitin ang aming API sa ilalim ng lisensyang Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Pakitiyak na kredito ka sa amin ng isang link kung gagamitin mo ang aming API sa iyong website o app.

Pagpapatotoo & mga limitasyon sa rate

Kailangan mo ng API key para sa lahat ng API call. Kunin ang sa iyo sa iyong Pahina ng profile (kailangan mong magkaroon ng account at naka-log-in upang ma-access ang pahinang ito).

Ang lahat ng mga endpoint ng API ay nasa ilalim ng https://coinlib.io/api/v1. Gamitin ang GET para ma-access ang API.

Ni-rate namin ang limitasyon sa API bawat endpoint at bawat oras. Kasama sa lahat ng mga tugon ang natitira na mga kahilingan na maaari mong gawin hanggang sa simula ng susunod na oras.

Dapat kang palaging mag-isyu ng isang kahilingan sa isang pagkakataon, kung susubukan mong gumawa ng mga parallel na kahilingan, isang 429 ang ibabalik. Sa wakas, huwag gumamit ng maraming API key.

Mga tugon

Ang mga tugon ay nasa JSON. Ibinabalik ang mga buong numero (bilang ng mga barya, ranggo, timestamp) bilang mga integer. Ang mga desimal na numero ay ibinabalik bilang mga string, gamit ang isang . bilang isang decimal point at pagkakaroon ng hanggang 10 mga numero ng katumpakan.

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

Mga endpoint


Mga istatistika ng pandaigdigang merkado

Endpoint:
/global

Mga kinakailangang param:
key: API key

Mga opsyonal na param:
pref: simbolo na gagamitin para sa mga presyo at iba pang halaga sa pamilihan. Ang default ay USD.

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

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

Listahan ng barya

Endpoint:
/coinlist

Mga kinakailangang param:
key: API key

Mga opsyonal na param:
pref: simbolo na gagamitin para sa mga presyo at iba pang halaga sa pamilihan. Ang default ay USD.
page: integer, simula sa 1. Sa ngayon ay nagbabalik kami ng 100 resulta sa bawat pahina, ngunit maaaring magbago ito nang walang babala.
order: Halimbawa:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

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

Impormasyon ng barya

Endpoint:
/coin

Mga kinakailangang param:
key: API key
symbol: simbolo ng solong barya o isang listahan ng mga simbolo na pinaghihiwalay ng kuwit

Mga opsyonal na param:
pref: simbolo na gagamitin para sa mga presyo at iba pang halaga sa pamilihan. Ang default ay USD.

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

Resulta: 
        {
            "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
        }
Mga Tala:
symbol: Palaging kakaiba.
show_symbol: Ang simbolo na ginagamit ng barya. Ang ilang mga barya ay gumagamit ng parehong simbolo tulad ng iba pang mga barya.
total_volume_24h: Ang kabuuang volume para sa lahat ng mga market na nilahukan ng coin na ito ay na-convert sa iyong pref pera.
markets: Ipinapakita namin ang nangungunang 3 pares para sa napiling barya. Kung ang iyong pref currency ay nakalakal, ito ay palaging kasama muna.
exchanges: Ang nangungunang 3 ay nagpapalitan ayon sa dami para sa pares.

Advanced:
Makakakuha ka ng impormasyon para sa hanggang 10 coin sa isang tawag. Ang bawat barya ay binibilang laban sa iyong quota. Magbigay ng listahan ng mga simbolo na pinaghihiwalay ng kuwit ie:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Ang resulta sa kasong ito ay mukhang: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }