Skip to content

Latest commit

 

History

History
106 lines (83 loc) · 2.28 KB

api.md

File metadata and controls

106 lines (83 loc) · 2.28 KB
Raw

API

API calls are requested by providing the name of the call as a form parameter.

For example, to request the vsp call:

https://api.decred.org/?c=vsp

Download Count

Uses GitHub API to retrieve download count from decred/decred-binaries and decred/decred-release, sums them together, and rounds the result down to the nearest 1,000.

Example: https://api.decred.org/?c=dc

["DownloadsCount","609k"]

Coin Supply

Uses dcrdata API to retrieve total number of Decred mined so far.

Example: https://api.decred.org/?c=gcs

{
    "Airdrop":7,
    "CoinSupplyMined":11915785,
    "CoinSupplyMinedRaw":1191578535131039,
    "CoinSupplyTotal":21000000,
    "PercentMined":56.7,
    "Pos":25.8,
    "Pow":51.5,
    "Premine":7,
    "Subsidy":8.6
}

Get VSP Info

Collects data from a hard-coded list of Voting Service Providers running decred/vspd.

Example: https://api.decred.org/?c=vsp

{
    "teststakepool.decred.org": {
        "network": "testnet",
        "launched": 1590969600,
        "lastupdated": 1596615074,
        "apiversions": [3],
        "feepercentage": 5,
        "closed": false,
        "voting": 3935,
        "voted": 57073,
        "revoked": 83
    },
}

Get VSP Info (legacy)

Collects data from a hard-coded list of Voting Service Providers running decred/dcrstakepool.

Example: https://api.decred.org/?c=gsd

{
    "Alpha":{
        "APIEnabled":true,
        "APIVersionsSupported":[1, 2],
        "Network":"testnet",
        "URL":"https://teststakepool.decred.org",
        "Launched":1516579200,
        "LastUpdated":1598266266,
        "Immature":0,
        "Live":1,
        "Voted":616,
        "Missed":10,
        "PoolFees":1,
        "ProportionLive":0.00015578750584203146,
        "ProportionMissed":0.01597444089456869,
        "UserCount":7,
        "UserCountActive":5,
        "Version":"1.5.0-pre"
    },
}

Clear Cache

Clear cached data. Can only be called from localhost (::1 or 127.0.0.1).

Example: https://api.decred.org/?c=cc

{"response": "cache cleared"}