¿Quiere extraer las estadísticas / datos de minería y analizarlos usted mismo? ¡La API del pool está aquí para ti!
TABLA DE CONTENIDO
- API de estadísticas del pool
- API de perfil de usuario
- API Recompensa Diaria
- API de Tasa de hash Diaria
- API Recompensas de los bloques
- API de trabajador
Visión general
La API del pool proporciona datos en archivos JSON en tres puntos finales: estadísticas, perfil y trabajadores. Debe incluir la abreviatura de la moneda seleccionada (por ejemplo, btc) y su token de acceso en cada URL de API.
Para adquirir el token de acceso (clave API) necesario para la autenticación API, siga estos pasos:
- Vaya a Configuración > Perfiles de acceso
- Seleccione uno de sus perfiles de acceso o cree uno nuevo
- Seleccione Permitir el acceso a las API web en el detalle del perfil de acceso
- Haga clic en Generar token nuevo
- Guardar los cambios
Cada perfil de acceso tiene su propio token de acceso (en caso de que el acceso a la API esté habilitado). Los tokens de acceso se pueden regenerar en cualquier momento, cancelando efectivamente el token de acceso anterior que pertenecía al perfil de acceso seleccionado.
Autenticación API
Se debe incluir un token de perfil de acceso en el campo de encabezado HTTP llamado SlushPool-Auth-Token o X-SlushPool-Auth-Token para autenticar sus solicitudes.
Solicitud de ejemplo usando cURL:
curl https://pool.braiins.com/stats/json/btc/ -H "SlushPool-Auth-Token: <your access token>"
Límite de solicitud de API
La API permite aproximadamente una solicitud cada cinco segundos (valor seguro). Cuando exceda temporalmente este límite, algunas de sus solicitudes serán ignoradas. En caso de que la tasa de solicitud permitida se exceda en gran medida o durante un período de tiempo más largo, su dirección IP podría ser prohibida. Si ese es el caso, contáctenos para resolver la situación.
API de estadísticas del pool
Proporciona información sobre el rendimiento del pool y los bloques encontrados recientemente.
URL:
https://pool.braiins.com/stats/json/[coin]/
Salida de muestra:
{
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,
},
}
}
}Estadísticas generales del Pool
| Campo | Tipo | Descripción |
| luck_b10 | frase | Suerte del pool durante los últimos diez bloques |
| luck_b50 | frase | Suerte del pool durante los últimos 50 bloques |
| luck_b250 | frase | Suerte del pool durante los últimos 250 bloques |
| hash_rate_unit | frase | Unidad utilizada para los valores de la tasa de hash |
| pool_scoring_hash_rate | número | Puntuación de tasa de hash del pool |
| pool_active_workers | número | Número de trabajadores activos del pool |
| round_probability | frase | CDF actual para la ronda actual |
| round_started | número | Hora Unix en la que se inició la ronda actual |
| round_duration | número | Duración de la ronda actual (segundos) |
| blocks | objeto | Información de los últimos 15 bloques (desglose a continuación) |
Últimos bloques
| Campo | Tipo | Descripción |
| date_found | número | Hora de Unix cuando se encontró el bloque dado |
| mining_duration | número | Duración de la ronda que conduce al bloque dado |
| total_shares | número | Número de shares recolectadas durante la ronda |
| state | frase | Estado del bloque dado |
| confirmations_left | número | Número de confirmaciones restantes |
| value | frase | Valor de bloque |
| user_reward | frase | Recompensa de usuario por el bloque dado |
| pool_scoring_hash_rate | número | Puntuación de tasa de hash del pool en el momento en que se encontró el bloque |
API de perfil de usuario
Proporciona información sobre el rendimiento y las recompensas de los usuarios.
URL:
https://pool.braiins.com/accounts/profile/json/[coin]/
Salida de muestra:
{
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,
}
}| Campo | Tipo | Descripción |
| username | frase | Nombre de usuario |
| confirmed_reward | frase | Recompensa confirmada |
| unconfirmed_reward | frase | Recompensa no confirmada |
| estimated_reward | frase | Recompensa estimada para el bloque actual |
| all_time_reward | frase | Recompensa histórica acumulada |
| hash_rate_unit | frase | Unidad utilizada para los valores de la tasa de hash |
| hash_rate_5m | frase | Tasa de hash promedio de los últimos 5 minutos |
| hash_rate_60m | número | Tasa de hash promedio de los últimos 60 minutos |
| hash_rate_24h | número | Tasa de hash promedio de las últimas 24 horas |
| hash_rate_scoring | número | Puntuación de tasa de hash actual del usuario |
| hash_rate_yesterday | número | Tasa de hash promedio para el día UTC anterior |
| low_workers | número | Número de trabajadores con estado 'bajo' |
| off_workers | número | Número de trabajadores con estado 'apagado' |
| ok_workers | número | Número de trabajadores con estado 'ok' |
| dis_workers | número | Número de trabajadores con monitoreo deshabilitado |
API Recompensa Diaria
Provee información sobre las recompensas para los últimos 90 días. Tenga en cuenta que, en un día determinado, los datos sólo estarán disponibles después de que el último bloque encontrado ese día (UTC) haya obtenido 100 confirmaciones, es decir, aproximadamente 20 horas después.
URL:
https://pool.braiins.com/accounts/rewards/json/<coin>/
Salida de muestra:
{
"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"
},
]
}
}| Campo | Tipo | Descripción |
| date | número | Hora Unix (el primer segundo de la fecha) |
| total_reward | número | La suma de todas los tipos de recompensas del día |
| mining_reward | número | La recompensa estandar de minería |
| bos_plus_reward | número | La cantidad reintegrada (reintegro de la comisión del pool) por minar con Braiins OS+ |
| referral_bonus | número | Bono recibido por ser referido a Braiins OS+ |
| referral_reward | número | Recompensa ganada por referir TH a Braiins OS+ |
API de Tasa de hash Diaria
Provee información sobre promedios diarios de la tasa de hash por usuario o grupo de usuario.
URL:
https://pool.braiins.com/accounts/hash_rate_daily/json/[group]/[coin]
Donde group está indicando si se deben devolver las tasas medias de hash para el grupo de usuarios. La variable coin es BTC.
Ejemplo de petición URL:
https://pool.braiins.com/accounts/hash_rate_daily/json/group/btc
Ejemplo de salida:
{
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,
},
]
}| Campo | Tipo | Descripción |
| date | número | tiempo Unix (el primer segundo de la fecha) |
| hash_rate_unit | frase | unidad utilizada para los valores de tasa de hash |
| hash_rate_24h | número | tasa de hash promedio en las últimas 24 horas |
| scoring_hash_rate_24h | número | tasa de hash promedio ponderada en las últimas 24 horas |
| total_shares | número | número de participaciones recogidas durante el día |
API Recompensas de los bloques
Provee información sobre las recompensas de los bloques.
URL:
https://pool.braiins.com/accounts/block_rewards/json/[coin]?from=[from date]&to=[to date]
Donde COIN es BTC o ZEC, la fecha FROM es el valor representado en formato ISO (AAAA-MM-DD), y la fecha TO es el valor representado en formato ISO (AAAA-MM-DD).
URL:
https://pool.braiins.com/accounts/block_rewards/json/btc?from=2022-05-01&to=2022-05-07
Ejemplo de Salida:
{
"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"
}
}| Campo | Tipo | Descripción |
| block_found_at | número | Hora Unix (UTC), cuando se encontro el bloque |
| pool_scoring_hash_rate | número | Tasa de hash del pool al momento que se encontro el bloque |
| user_scoring_hash_rate | número | Tasa de hash del usuario al momento que se encontro el bloque |
| block_value | frase | Valor total del bloque |
| user_reward | frase | Recompensa total para el usuario |
| block_heigh | número | Numero de bloque dentro del blockchain |
| mining_reward | frase | Cantidad de recompensa de minando por los shares entregados en el bloque |
| braiinsos_plus_mining_bonus | frase | Tarifa del pool reembolsada por minar con Braiins OS+ |
| referral_reward | frase | Tarifa del pool reembolsada por minar con Braiins OS+ y con un codigo de referencia |
| referral_bonus | frase | Tarifa del pool reembolsada por recomendacion para Braiins OS+ con un codigo de referencia |
| confirmations_left | número | Numero de confirmaciones restantes para que el bloque se considere valido |
API de trabajador
Brinda datos de desempeño para cada uno de los trabajadores del usuario.
URL:
https://pool.braiins.com/accounts/workers/json/[coin]/
Salida de muestra:
{
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,
},
}
}
}| Campo | Tipo | Descripción |
| last_share | número | Hora Unix del último share compartido aceptado |
| state | frase | Estado del trabajador (ok/bajo/apagado/des) |
| hash_rate_unit | frase | Unidad utilizada para los valores de la tasa de hash |
| hash_rate_scoring | número | Tasa de puntuación de hash actual |
| hash_rate_5m | número | Tasa de hash promedio de los últimos 5 minutos |
| hash_rate_60m | número | Tasa de hash promedio de los últimos 60 minutos |
| hash_rate_24h | número | Tasa de hash promedio de las últimas 24 horas |