Babylon Labs Stats API
The Stats API from Babylon Labs — 3 operation(s) for stats.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/babylon-labs-stats-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
email: contact@babylonlabs.io
description: 'The Babylon Staking API offers information about the state of the Babylon BTC Staking system.
Your access and use is governed by the API Access License linked to below.'
license:
name: API Access License
url: https://docs.babylonlabs.io/assets/files/api-access-license.pdf
title: Babylon Staking Stats API
version: '2.0'
tags:
- name: Stats
paths:
/v1/stats:
get:
deprecated: true
description: '[DEPRECATED] Fetches overall stats for babylon staking including tvl, total delegations, active tvl, active delegations and total stakers. Please use /v2/stats instead.'
responses:
'200':
description: Overall stats for babylon staking
content:
application/json:
schema:
$ref: '#/components/schemas/handler.PublicResponse-v1service_OverallStatsPublic'
summary: Get Overall Stats (Deprecated)
tags:
- Stats
operationId: getV1Stats
x-operation-id-source: derived
/v1/stats/staker:
get:
deprecated: true
description: '[DEPRECATED] Fetches staker stats for babylon staking including tvl, total delegations, active tvl and active delegations. Please use /v2/staker/stats instead.
If staker_btc_pk query parameter is provided, it will return stats for the specific staker.
Otherwise, it will return the top stakers ranked by active tvl.'
parameters:
- description: Public key of the staker to fetch
in: query
name: staker_btc_pk
schema:
type: string
- description: Pagination key to fetch the next page of top stakers
in: query
name: pagination_key
schema:
type: string
responses:
'200':
description: List of top stakers by active tvl
content:
application/json:
schema:
$ref: '#/components/schemas/handler.PublicResponse-array_v1service_StakerStatsPublic'
'400':
description: 'Error: Bad Request'
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_babylonlabs-io_staking-api-service_internal_shared_types.Error'
summary: Get Staker Stats (Deprecated)
tags:
- Stats
operationId: getV1StatsStaker
x-operation-id-source: derived
/v2/stats:
get:
description: Overall system stats including max staking APR (BTC + co-staking)
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/handler.PublicResponse-v2service_OverallStatsPublic'
'400':
description: 'Error: Bad Request'
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_babylonlabs-io_staking-api-service_internal_shared_types.Error'
tags:
- Stats
summary: Get stats
x-summary-source: derived
operationId: getV2Stats
x-operation-id-source: derived
components:
schemas:
handler.PublicResponse-v2service_OverallStatsPublic:
properties:
data:
$ref: '#/components/schemas/v2service.OverallStatsPublic'
pagination:
$ref: '#/components/schemas/handler.paginationResponse'
type: object
handler.PublicResponse-v1service_OverallStatsPublic:
properties:
data:
$ref: '#/components/schemas/v1service.OverallStatsPublic'
pagination:
$ref: '#/components/schemas/handler.paginationResponse'
type: object
v1service.StakerStatsPublic:
properties:
active_delegations:
type: integer
active_tvl:
type: integer
staker_pk_hex:
type: string
total_delegations:
type: integer
total_tvl:
type: integer
type: object
types.ErrorCode:
enum:
- INTERNAL_SERVICE_ERROR
- VALIDATION_ERROR
- NOT_FOUND
- BAD_REQUEST
- FORBIDDEN
- UNPROCESSABLE_ENTITY
- REQUEST_TIMEOUT
type: string
x-enum-varnames:
- InternalServiceError
- ValidationError
- NotFound
- BadRequest
- Forbidden
- UnprocessableEntity
- RequestTimeout
handler.paginationResponse:
properties:
next_key:
type: string
type: object
v2service.OverallStatsPublic:
properties:
active_delegations:
type: integer
active_finality_providers:
type: integer
active_tvl:
type: integer
btc_staking_apr:
description: Represents the APR for BTC staking as a decimal (e.g., 0.035 = 3.5%)
type: number
max_staking_apr:
description: Represents the max staking APR (BTC + Co-staking) as a decimal
type: number
total_active_delegations:
description: 'This represents the total active delegations on BTC chain which includes
both phase-1 and phase-2 active delegations'
type: integer
total_active_tvl:
description: 'This represents the total active tvl on BTC chain which includes
both phase-1 and phase-2 active tvl'
type: integer
total_finality_providers:
type: integer
type: object
github_com_babylonlabs-io_staking-api-service_internal_shared_types.Error:
properties:
err: {}
errorCode:
$ref: '#/components/schemas/types.ErrorCode'
statusCode:
type: integer
type: object
handler.PublicResponse-array_v1service_StakerStatsPublic:
properties:
data:
items:
$ref: '#/components/schemas/v1service.StakerStatsPublic'
type: array
pagination:
$ref: '#/components/schemas/handler.paginationResponse'
type: object
v1service.OverallStatsPublic:
properties:
active_delegations:
type: integer
active_tvl:
type: integer
btc_price_usd:
description: Optional field
type: number
pending_tvl:
type: integer
total_delegations:
type: integer
total_stakers:
type: integer
total_tvl:
type: integer
unconfirmed_tvl:
type: integer
type: object