Хотите получить статистики/данные по майнингу и проанализировать их самостоятельно? API к вашим услугам!
ОГЛАВЛЕНИЕ
- Обзор
- Статистики API пула
- API профиля пользователя
- API ежедневного вознаграждения
- API ежедневного хешрейта
- API вознаграждения за все время
- API воркера
Обзор
API пула предоставляет данные в файлах JSON по трем значениям: статистики, профиль и воркеры. Вы должны включить аббревиатуру выбранной монеты (например, btc) и свой токен доступа в каждый API URL.
Чтобы получить токен доступа, необходимый для аутентификации API, выполните следующие действия:
- Перейдите на Настройки > Профили доступа
- Выберите один из ваших профилей доступа или создайте новый
- Выберите Разрешить доступ к веб-API в деталях профиля доступа
- Нажмите на Создать новый токен
- Сохраните изменения
Каждый профиль доступа имеет свой собственный токен доступа (при условии, что доступ по API включен). Токены доступа могут быть восстановлены в любое время, отменяя при этом прежний токен доступа, принадлежащий выбранному профилю доступа.
API аутентификация
Токен доступа должен быть включен в поле заголовка HTTP (HTTP header) с названием SlushPool-Auth-Token или X-SlushPool-Auth-Token для проверки подлинности ваших запросов.
Пример запроса с использованием cURL:
curl https://pool.braiins.com/stats/json/btc/ -H "SlushPool-Auth-Token: <your access token>"
Предел API запросов
API разрешает примерно один запрос за пять секунд (безопасный уровень). Если вы ненадолго превысите этот предел, некоторые ваши запросы будут игнорироваться. В случае значительного превышения разрешенной частоты запросов в течение более длительного периода времени ваш IP-адрес может быть заблокирован. Если так случиться, пожалуйста, свяжитесь с нами, чтобы разрешить ситуацию.
Статистики API пула
Предоставляет информацию о производительности пула и недавно найденных блоках.
URL:
https://pool.braiins.com/stats/json/[coin]/
Пример выходных данных:
{
btc: {
luck_b10: "0.77",
luck_b50: "0.85",
luck_b250: "0.93",
hash_rate_unit: "Gh/s",
pool_scoring_hash_rate: 5820970883.3011,
pool_active_workers: 219210,
round_probability: "0.67",
round_started: 1542096907,
round_duration: 5913,
blocks: {
549753: {
date_found: 1542002919,
mining_duration: 3423,
total_shares: 4640771710739,
state: "confirmed",
confirmations_left: 0,
value: "12.92594863",
user_reward: "0.00006194",
pool_scoring_hash_rate: 5878745444.967269,
},
}
}
}Общие статистики пула
| Поле | Тип | Описание |
| luck_b10 | string | удача пула за последних десять блоков |
| luck_b50 | string | удача пула за последних 50 блоков |
| luck_b250 | string | удача пула за последних 250 блоков |
| hash_rate_unit | string | единица, используемая для значений хешрейта |
| pool_scoring_hash_rate | number | оценочный хэшрейт пула |
| pool_active_workers | number | количество активных воркеров пула |
| round_probability | string | текущий CDF для текущего раунда |
| round_started | number | Unix время, в моменте, когда начался текущеий раунд |
| round_duration | number | продолжительность текущего раунда (в секундах) |
| blocks | object | информация за последних 15 блоков (подробнее ниже) |
Последние блоки
| Поле | Тип | Описание |
| date_found | number | Unix время, в моменте, когда был найден данный блок |
| mining_duration | number | продолжительность раунда, ведущего к данному блоку |
| total_shares | number | количество решений, собранных в течение раунда |
| state | string | состояние данного блока |
| confirmations_left | number | количество недостающих подтверждений |
| value | string | значение блока |
| user_reward | string | вознаграждение пользователя за данный блок |
| pool_scoring_hash_rate | number | оценочный хэшрейт пула в момент обнаружения блока |
API профиля пользователя
Предоставляет информацию о производительности пользователей и их вознаграждениях.
URL:
https://pool.braiins.com/accounts/profile/json/[coin]/
Пример выходных данных:
{
username: "username",
btc: {
confirmed_reward: "0.00765122",
unconfirmed_reward: "0.00062272",
estimated_reward: "0.00006014",
send_threshold: "0.01000000",
hash_rate_unit: "Gh/s",
hash_rate_5m: 27978,
hash_rate_60m: 28191,
hash_rate_24h: 28357,
hash_rate_scoring: 28294,
hash_rate_yesterday: 28197,
low_workers: 0,
off_workers: 0,
ok_workers: 2,
dis_workers: 2,
}
}| Поле | Тип | Описание |
| username | string | имя пользователя |
| confirmed_reward | string | подтвержденное вознаграждение |
| unconfirmed_reward | string | неподтвержденное вознаграждение |
| estimated_reward | string | предполагаемое вознаграждение за текущий блок |
| all_time_reward | string | совокупное вознаграждение за все время |
| hash_rate_unit | string | единица, используемая для значений хэшрейта |
| hash_rate_5m | string | средний хэшрейт за последних 5 минут |
| hash_rate_60m | number | средний хэшрейт за последних 60 минут |
| hash_rate_24h | number | средний хэшрейт за последние 24 часа |
| hash_rate_scoring | number | текущий оценочный хэшрейт пользователя |
| hash_rate_yesterday | number | средний хешрейт за предыдущий день UTC |
| low_workers | number | количество воркеров со значением "Низкий" |
| off_workers | number | количество воркеров со значением "Оф-лайн" |
| ok_workers | number | количество воркеров со значением "ОК" |
| dis_workers | number | количество работников у которых был отключен мониторинг |
API ежедневного вознаграждения
Предоставляет информацию о вознаграждениях за последние 90 дней. Обратите внимание, что данные за любой конкретный день становятся доступными только после того, как последний блок, найденный в этот день (UTC), получает 100 подтверждений, то есть примерно через 20 часов.
URL:
https://pool.braiins.com/accounts/rewards/json/<coin>/
Пример выходных данных:
{
"btc":{
"daily_rewards":[
{
"date":1627862400,
"total_reward":"0.36361081",
"mining_reward":"0.35648119",
"bos_plus_reward":"0.00712962",
"referral_bonus":"0.00000000",
"referral_reward":"0.00000000"
},
]
}
}| Поле | Тип | Описание |
| date | number | Unix время (первая секунда даты) |
| total_reward | number | сумма всех видов вознаграждений за день |
| mining_reward | number | стандартное вознаграждение за майнинг |
| bos_plus_reward | number | возвращаемая сумма (возврат комиссии пула) за майнинг с Braiins OS+ |
| referral_bonus | number | бонус, полученный за реферал в Braiins OS+ |
| referral_reward | number | вознаграждение, полученное за реферальный HR Braiins OS+ |
API ежедневного хешрейта
Предоставляет информацию о среднесуточных значениях хешрейта для пользователя или группы пользователей.
URL:
https://pool.braiins.com/accounts/hash_rate_daily/json/[group]/[coin]
Где group указывает, следует ли возвращать среднего хешрейта для группы пользователей. Переменная coin — BTC.
Пример URL запроса:
https://pool.braiins.com/accounts/hash_rate_daily/json/group/btc
Пример выходных данных:
{
btc: [
{
date: 1662674400,
hash_rate_unit: "Gh/s",
hash_rate_24h: 1073.7,
scoring_hash_rate_24h: 322122.5,
total_shares: 21600000,
},
{
date: 1662588000,
hash_rate_unit: "Gh/s",
hash_rate_24h: 1000.7,
scoring_hash_rate_24h: 322100.5,
total_shares: 21200000,
},
]
}| Поле | Тип | Описание |
| date | number | Unix время (первая секунда даты) |
| hash_rate_unit | string | единица, используемая для значений хешрейта |
| hash_rate_24h | number | единица, используемая для измерения хешрейта |
| scoring_hash_rate_24h | number | средний скоринговый хешрейт за последние 24 часа |
| total_shares | number | количество акций, собранных в течение дня |
API вознаграждения за все время
Предоставляет информацию о вознаграждениях за все время.
URL:
https://pool.braiins.com/accounts/block_rewards/json/[coin]?from=[from date]&to=[to date]
Где COIN — BTC, FROM date — это строковое представление даты в формате ISO (YYYY-MM-DD), и TO date — строковое представление даты в формате ISO (YYYY-MM-DD).
Пример URL-запроса:
https://pool.braiins.com/accounts/block_rewards/json/btc?from=2022-05-01&to=2022-05-07
Пример выходных данных:
{
"btc": {
"block_rewards": [
{
"block_found_at": 1651804117,
"pool_scoring_hash_rate": 4441768989.204721,
"user_scoring_hash_rate": 12981.581642348925,
"block_value": "12.59169582",
"user_reward": "0.06366676",
"block_height": 567815,
"mining_reward": "0.06366676",
"braiinsos_plus_mining_bonus": "0.00000000",
"referral_reward": "0.00000000",
"referral_bonus": "0.00000000",
"confirmations_left": 0
},
{
"block_found_at": 1651811734,
"pool_scoring_hash_rate": 4441768989.387698,
"user_scoring_hash_rate": 13041.508413918604,
"block_value": "12.66780812",
"user_reward": "0.07129083",
"block_height": 567816,
"mining_reward": "0.07129083",
"braiinsos_plus_mining_bonus": "0.00000000",
"referral_reward": "0.00000000",
"referral_bonus": "0.00000000",
"confirmations_left": 0
}
],
"hash_rate_unit": "Gh/s"
}
}| Поле | Тип | Описание |
| block_found_at | number | временная метка unix (UTC), когда блок был найден |
| pool_scoring_hash_rate | number | общий скоринговый хешрейт пула на момент обнаружения блока |
| user_scoring_hash_rate | number | общий скоринговый хешрейт пользователя на момент обнаружения блока |
| block_value | string | общая стоимость блока |
| user_reward | string | общая сумма вознаграждения для пользователя |
| block_heigh | number | номер блока в блокчейне монеты |
| mining_reward | string | сумма вознаграждения за доставленные решения в блоке |
| braiinsos_plus_mining_bonus | string | возврат комиссии пула за майнинг на устройстве Braiins OS+ |
| referral_reward | string | возврат комиссии пула за майнинг с помощью устройства Braiins OS+ и специального реферального кода |
| referral_bonus | string | возврат платы за распространение Braiins OS+ с выделенным реферальным кодом |
| confirmations_left | number | количество подтверждений, оставшихся до того, как блок будет считаться действительным |
API воркера
Предоставляет данные о производительности для каждого из воркеров пользователя.
URL:
https://pool.braiins.com/accounts/workers/json/[coin]/
Пример выходных данных:
{
btc: {
workers: {
username.worker1: {
state: "ok",
last_share: 1542103204,
hash_rate_unit: "Gh/s",
hash_rate_scoring: 15342,
hash_rate_5m: 14977,
hash_rate_60m: 15302,
hash_rate_24h: 15351,
},
username.worker2: {
state: "ok",
last_share: 1542103200,
hash_rate_unit: "Gh/s",
hash_rate_scoring: 12952,
hash_rate_5m: 13001,
hash_rate_60m: 12889,
hash_rate_24h: 13006,
},
}
}
}| Поле | Тип | Описание |
| last_share | number | Unix время последнего принятого решения |
| state | string | Значения воркера (ОК/Низкий/Оф-лайн/Мониторинг отключен) |
| hash_rate_unit | string | единица, используемая для значений хешрейта |
| hash_rate_scoring | number | текущий оценочный хешрейт |
| hash_rate_5m | number | средний хешрейт за последних 5 минут |
| hash_rate_60m | number | средний хешрейт за последних 60 минут |
| hash_rate_24h | number | средний хэшрейт за последние 24 часа |