Domination Finance API (v0)

Download OpenAPI specification:Download

price

Get all latest price identifier values

query Parameters

timestamp

number

(optional) The requested Unix timestamp in seconds of the historical snapshot of the CoinGecko coin dominance. If omitted, defaults to the last snapshot retreived.

Responses

Response samples

Content type

application/json

{"status": "success",
"data": {"bitcoin": "61.80",
"ethereum": "11.66",
"ripple": "4.77",
"tether": "3.42",
"litecoin": "0.95",
"bitcoin-cash": "0.91",
"chainlink": "0.90",
"polkadot": "0.82",
"binancecoin": "0.75",
"bitcoin-cash-sv": "0.58",
"others": "13.42"
},
"timestamp": 1607636104,
"meta": {"provenance_uuid": "5094f548-ea15-400c-9c54-15403489d761",
"requested_timestamp": 1607636104000,
"actual_timestamp": 1607636104000
}
}

Get individual coin's price identifier value

path Parameters

required

string

ID of the coin. For example: bitcoin

query Parameters

timestamp

number

(optional) The requested Unix timestamp in seconds of the historical snapshot of the CoinGecko coin dominance. If omitted, defaults to the last snapshot retreived.

Responses

Response samples

Content type

application/json

{"status": "success",
"coin_id": "bitcoin",
"coin_symbol": "BTC",
"price": "61.57",
"price_original": "61.5685121938972300",
"timestamp": 1607636098,
"meta": {"provenance_uuid": "c53c674f-0447-4870-8342-383eda8f6964",
"requested_timestamp": 1607636098000,
"actual_timestamp": 1607636098000
}
}

coingecko

Fetch coin dominance snapshot

query Parameters

timestamp

number

(optional) The requested Unix timestamp in seconds of the historical snapshot of the CoinGecko coin dominance. If omitted, defaults to the last snapshot retreived.

Responses

Response samples

Content type

application/json

{"status": "success",
"data": [{"name": "BTC",
"id": "bitcoin",
"market_cap_usd": 339041025460.1014,
"dominance_percentage": 61.75840832836481,
"price_identifier": 61.76
},
{"name": "ETH",
"id": "ethereum",
"market_cap_usd": 64588129662.01142,
"dominance_percentage": 11.76512511846825,
"price_identifier": 11.77
},
{"name": "XRP",
"id": "ripple",
"market_cap_usd": 25040411223.96337,
"dominance_percentage": 4.561264935360123,
"price_identifier": 4.56
},
{"name": "USDT",
"id": "tether",
"market_cap_usd": 19744888960.14286,
"dominance_percentage": 3.596652980694298,
"price_identifier": 3.6
},
{"name": "LTC",
"id": "litecoin",
"market_cap_usd": 4997380714.34336,
"dominance_percentage": 0.9103036374724288,
"price_identifier": 0.91
},
{"name": "BCH",
"id": "bitcoin-cash",
"market_cap_usd": 4921216455.157296,
"dominance_percentage": 0.896429849152986,
"price_identifier": 0.9
},
{"name": "LINK",
"id": "chainlink",
"market_cap_usd": 4896345773.519331,
"dominance_percentage": 0.8918995015057718,
"price_identifier": 0.89
},
{"name": "DOT",
"id": "polkadot",
"market_cap_usd": 4592928305.911634,
"dominance_percentage": 0.8366301433711772,
"price_identifier": 0.84
},
{"name": "BNB",
"id": "binancecoin",
"market_cap_usd": 4149307985.253904,
"dominance_percentage": 0.7558219731246407,
"price_identifier": 0.76
},
{"name": "BSV",
"id": "bitcoin-cash-sv",
"market_cap_usd": 3099812408.765371,
"dominance_percentage": 0.5646498981120874,
"price_identifier": 0.56
},
{"name": "Others",
"id": "",
"market_cap_usd": 73908092253.72815,
"dominance_percentage": 13.46281363437342,
"price_identifier": 13.46
}
],
"timestamp": 1607554356,
"meta": {"provenance_uuid": "1f89eb24-3b5f-4d57-bd05-76d947a9ffa8",
"blob_sha256": "a902355cd3024cd687aa926faebdfe30474eb38f607278c16404221bb93d3942",
"imported_at_timestamp": 1607554295123,
"requested_timestamp": 1607554356000,
"actual_timestamp": 1607554356000
}
}

provenance

Find data provenance record

path Parameters

uuid

required

string

Responses

Response samples

Content type

application/json

{"uuid": "7fd0978b-4482-41b5-9d6b-882939d25147",
"agent": "loader_rust",
"imported_at": "2020-11-14T04:32:43.147949Z",
"data": "eyJkYXRhIjpbeyJuYW1lIjoiQlRDIiwiaWQiOiJiaXRjb2luIiwibWFya2V0X2NhcF91c2QiOjI5OTIzMDI0NDYxNC4zNzIyLCJkb21pbmFuY2VfcGVyY2VudGFnZSI6NjMuNjA0MDk0NjQ3NDY2MTd9LHsibmFtZSI6IkVUSCIsImlkIjoiZXRoZXJldW0iLCJtYXJrZXRfY2FwX3VzZCI6NTMyMjQ5ODE4MjEuMjc2NTksImRvbWluYW5jZV9wZXJjZW50YWdlIjoxMS4zMTM0NTEyMzc5Njg2ODl9LHsibmFtZSI6IlVTRFQiLCJpZCI6InRldGhlciIsIm1hcmtldF9jYXBfdXNkIjoxNzgyMTY3NzEyMS40OTQwOCwiZG9taW5hbmNlX3BlcmNlbnRhZ2UiOjMuNzg4MTU4NjQ2NDM5MzM3M30seyJuYW1lIjoiWFJQIiwiaWQiOiJyaXBwbGUiLCJtYXJrZXRfY2FwX3VzZCI6MTIzMzM3ODY4NTkuMTYyOTMsImRvbWluYW5jZV9wZXJjZW50YWdlIjoyLjYyMTY1Nzk0MDIzNTQ3ODd9LHsibmFtZSI6IkxJTksiLCJpZCI6ImNoYWlubGluayIsIm1hcmtldF9jYXBfdXNkIjo0OTYyODAxMDcxLjg3MzM1NiwiZG9taW5hbmNlX3BlcmNlbnRhZ2UiOjEuMDU0ODg4MjUwMDEyMjA2M30seyJuYW1lIjoiQkNIIiwiaWQiOiJiaXRjb2luLWNhc2giLCJtYXJrZXRfY2FwX3VzZCI6NDc5NTUwNDM3MC45NjA5ODQsImRvbWluYW5jZV9wZXJjZW50YWdlIjoxLjAxOTMyNzgyMzI0ODY4N30seyJuYW1lIjoiTFRDIiwiaWQiOiJsaXRlY29pbiIsIm1hcmtldF9jYXBfdXNkIjo0MjA5OTk1NTE2LjI3OTI2MSwiZG9taW5hbmNlX3BlcmNlbnRhZ2UiOjAuODk0ODcyNjIxMDA3Njg2M30seyJuYW1lIjoiRE9UIiwiaWQiOiJwb2xrYWRvdCIsIm1hcmtldF9jYXBfdXNkIjo0MTg1MTg0NTE0LjM1MDkyOTcsImRvbWluYW5jZV9wZXJjZW50YWdlIjowLjg4OTU5ODgxODE2NDA1NH0seyJuYW1lIjoiQk5CIiwiaWQiOiJiaW5hbmNlY29pbiIsIm1hcmtldF9jYXBfdXNkIjo0MTA0NzA4NDcyLjUzODIzLCJkb21pbmFuY2VfcGVyY2VudGFnZSI6MC44NzI0OTI5MDc2NzM5Mzk4fSx7Im5hbWUiOiJCU1YiLCJpZCI6ImJpdGNvaW4tY2FzaC1zdiIsIm1hcmtldF9jYXBfdXNkIjoyOTc2MDU4Mjk0LjQ5NjE1MywiZG9taW5hbmNlX3BlcmNlbnRhZ2UiOjAuNjMyNTg4MTA1MTM0NDA0NH0seyJuYW1lIjoiT3RoZXJzIiwiaWQiOiIiLCJtYXJrZXRfY2FwX3VzZCI6NjI2MTI1NzQ2OTcuODQ2OTI0LCJkb21pbmFuY2VfcGVyY2VudGFnZSI6MTMuMzA4ODY5MDAyNjQ5MzV9XSwidGltZXN0YW1wIjoxNjA1MzI4Mzg5fQ==",
"sha256": "086b6234cf2a3bc94badaf0ef7b0b1a503b949e615e3d41899a7e9b2a4fd0975",
"request_metadata": {"url": "https://api.coingecko.com/api/v3/global/coin_dominance?_=3684404360808481913",
"method": "GET",
"headers": [ ]
},
"response_metadata": {"url": "https://api.coingecko.com/api/v3/global/coin_dominance?_=3684404360808481913",
"status": 200,
"headers": [{"key": "date",
"value": "Sat, 14 Nov 2020 04:32:46 GMT"
},
{"key": "content-type",
"value": "application/json; charset=utf-8"
},
{"key": "set-cookie",
"value": "__cfduid=d5a8069ca7cf2d036b3c01fde0916ada11605328366; expires=Mon, 14-Dec-20 04:32:46 GMT; path=/; domain=.coingecko.com; HttpOnly; SameSite=Lax"
},
{"key": "cache-control",
"value": "max-age=60, public, must-revalidate, s-maxage=60"
},
{"key": "access-control-allow-origin",
"value": "*"
},
{"key": "access-control-allow-methods",
"value": "POST, PUT, DELETE, GET, OPTIONS"
},
{"key": "access-control-request-method",
"value": "*"
},
{"key": "access-control-allow-headers",
"value": "Origin, X-Requested-With, Content-Type, Accept, Authorization"
},
{"key": "access-control-expose-headers",
"value": "link, per-page, total"
},
{"key": "vary",
"value": "Accept-Encoding, Origin"
},
{"key": "etag",
"value": "W/\"76847eae80141fa266f3e810d8a9adc4\""
},
{"key": "x-request-id",
"value": "2b7221a4-ac17-47b7-9901-43f774757720"
},
{"key": "x-runtime",
"value": "0.181420"
},
{"key": "alternate-protocol",
"value": "443:npn-spdy/2"
},
{"key": "cf-cache-status",
"value": "MISS"
},
{"key": "cf-request-id",
"value": "0666a002e10000d28ed0107000000001"
},
{"key": "expect-ct",
"value": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""
},
{"key": "server",
"value": "cloudflare"
},
{"key": "cf-ray",
"value": "5f1e02b16d58d28e-DFW"
}
]
}
}

blob

Fetch raw snapshot data

path Parameters

sha256

required

string

SHA256 hash of the snapshot data.

Responses

Response samples

200
default

Content type

application/json

"{\"data\":[{\"name\":\"BTC\",\"id\":\"bitcoin\",\"market_cap_usd\":301286230643.5114,\"dominance_percentage\":63.63855444971209},{\"name\":\"ETH\",\"id\":\"ethereum\",\"market_cap_usd\":53827693079.692085,\"dominance_percentage\":11.369641983431773},{\"name\":\"USDT\",\"id\":\"tether\",\"market_cap_usd\":17687843178.759727,\"dominance_percentage\":3.7360777119659963},{\"name\":\"XRP\",\"id\":\"ripple\",\"market_cap_usd\":11996304334.51188,\"dominance_percentage\":2.5338943135786907},{\"name\":\"LINK\",\"id\":\"chainlink\",\"market_cap_usd\":5010810043.979014,\"dominance_percentage\":1.0583978801149712},{\"name\":\"BCH\",\"id\":\"bitcoin-cash\",\"market_cap_usd\":4783308192.999641,\"dominance_percentage\":1.0103442770676696},{\"name\":\"LTC\",\"id\":\"litecoin\",\"market_cap_usd\":4322972308.020535,\"dominance_percentage\":0.9131107917576092},{\"name\":\"DOT\",\"id\":\"polkadot\",\"market_cap_usd\":4231342022.304784,\"dominance_percentage\":0.8937563761432291},{\"name\":\"BNB\",\"id\":\"binancecoin\",\"market_cap_usd\":4143442578.914624,\"dominance_percentage\":0.8751899999024817},{\"name\":\"BSV\",\"id\":\"bitcoin-cash-sv\",\"market_cap_usd\":2996105779.877972,\"dominance_percentage\":0.6328461821923216},{\"name\":\"Others\",\"id\":\"\",\"market_cap_usd\":63147439922.15381,\"dominance_percentage\":13.338186034133168}],\"timestamp\":1605318784}\n"