Files
brk/modules/brk-client/docs/classes/BrkClient.md
2026-04-01 22:16:40 +02:00

56 KiB

brk-client


brk-client / BrkClient

Class: BrkClient

Defined in: Developer/brk/modules/brk-client/index.js:6548

Main BRK client with series tree and API methods

Extends

  • BrkClientBase

Constructors

Constructor

new BrkClient(options): BrkClient

Defined in: Developer/brk/modules/brk-client/index.js:7725

Parameters

options

string | BrkClientOptions

Returns

BrkClient

Overrides

BrkClientBase.constructor

Properties

_cache

_cache: Cache | null

Defined in: Developer/brk/modules/brk-client/index.js:1511

Inherited from

BrkClientBase._cache


_cachePromise

_cachePromise: Promise<Cache | null>

Defined in: Developer/brk/modules/brk-client/index.js:1509

Inherited from

BrkClientBase._cachePromise


series

series: SeriesTree

Defined in: Developer/brk/modules/brk-client/index.js:7728

Methods

_fetchSeriesData()

_fetchSeriesData<T>(path, onUpdate?): Promise<DateSeriesData<T>>

Defined in: Developer/brk/modules/brk-client/index.js:1599

Fetch series data and wrap with helper methods (internal)

Type Parameters

T

T

Parameters

path

string

onUpdate?

(value) => void

Returns

Promise<DateSeriesData<T>>

Inherited from

BrkClientBase._fetchSeriesData


dateToIndex()

dateToIndex(index, d): number

Defined in: Developer/brk/modules/brk-client/index.js:7717

Convert a Date to an index value for date-based indexes.

Parameters

index

Index

The index type

d

Date

The date to convert

Returns

number


get()

get(path): Promise<Response>

Defined in: Developer/brk/modules/brk-client/index.js:1519

Parameters

path

string

Returns

Promise<Response>

Inherited from

BrkClientBase.get


getAddress()

getAddress(address): Promise<AddrStats>

Defined in: Developer/brk/modules/brk-client/index.js:9431

Address information

Retrieve address information including balance and transaction counts. Supports all standard Bitcoin address types (P2PKH, P2SH, P2WPKH, P2WSH, P2TR).

Mempool.space docs

Endpoint: GET /api/address/{address}

Parameters

address

string

Returns

Promise<AddrStats>


getAddressConfirmedTxs()

getAddressConfirmedTxs(address, after_txid?): Promise<Transaction[]>

Defined in: Developer/brk/modules/brk-client/index.js:9469

Address confirmed transactions

Get confirmed transactions for an address, 25 per page. Use ?after_txid= for pagination.

Mempool.space docs

Endpoint: GET /api/address/{address}/txs/chain

Parameters

address

string

after_txid?

string

Txid to paginate from (return transactions before this one)

Returns

Promise<Transaction[]>


getAddressMempoolTxs()

getAddressMempoolTxs(address): Promise<string[]>

Defined in: Developer/brk/modules/brk-client/index.js:9489

Address mempool transactions

Get unconfirmed transaction IDs for an address from the mempool (up to 50).

Mempool.space docs

Endpoint: GET /api/address/{address}/txs/mempool

Parameters

address

string

Returns

Promise<string[]>


getAddressTxs()

getAddressTxs(address, after_txid?): Promise<Transaction[]>

Defined in: Developer/brk/modules/brk-client/index.js:9448

Address transactions

Get transaction history for an address, sorted with newest first. Returns up to 50 mempool transactions plus the first 25 confirmed transactions. Use ?after_txid= for pagination.

Mempool.space docs

Endpoint: GET /api/address/{address}/txs

Parameters

address

string

after_txid?

string

Txid to paginate from (return transactions before this one)

Returns

Promise<Transaction[]>


getAddressUtxos()

getAddressUtxos(address): Promise<Utxo[]>

Defined in: Developer/brk/modules/brk-client/index.js:9505

Address UTXOs

Get unspent transaction outputs (UTXOs) for an address. Returns txid, vout, value, and confirmation status for each UTXO.

Mempool.space docs

Endpoint: GET /api/address/{address}/utxo

Parameters

address

string

Returns

Promise<Utxo[]>


getApi()

getApi(): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:9415

Compact OpenAPI specification

Compact OpenAPI specification optimized for LLM consumption. Removes redundant fields while preserving essential API information. Full spec available at /openapi.json.

Endpoint: GET /api.json

Returns

Promise<any>


getBlock()

getBlock(hash): Promise<BlockInfo>

Defined in: Developer/brk/modules/brk-client/index.js:9537

Block information

Retrieve block information by block hash. Returns block metadata including height, timestamp, difficulty, size, weight, and transaction count.

Mempool.space docs

Endpoint: GET /api/block/{hash}

Parameters

hash

string

Returns

Promise<BlockInfo>


getBlockByHeight()

getBlockByHeight(height): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:9521

Block hash by height

Retrieve the block hash at a given height. Returns the hash as plain text.

Mempool.space docs

Endpoint: GET /api/block-height/{height}

Parameters

height

number

Returns

Promise<any>


getBlockByTimestamp()

getBlockByTimestamp(timestamp): Promise<BlockTimestamp>

Defined in: Developer/brk/modules/brk-client/index.js:10410

Block by timestamp

Find the block closest to a given UNIX timestamp.

Mempool.space docs

Endpoint: GET /api/v1/mining/blocks/timestamp/{timestamp}

Parameters

timestamp

number

Returns

Promise<BlockTimestamp>


getBlockFeeRates()

getBlockFeeRates(time_period): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:10346

Block fee rates (WIP)

Work in progress. Get block fee rate percentiles (min, 10th, 25th, median, 75th, 90th, max) for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/blocks/fee-rates/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<any>


getBlockFees()

getBlockFees(time_period): Promise<BlockFeesEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10362

Block fees

Get average block fees for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/blocks/fees/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<BlockFeesEntry[]>


getBlockHeader()

getBlockHeader(hash): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:9553

Block header

Returns the hex-encoded block header.

Mempool.space docs

Endpoint: GET /api/block/{hash}/header

Parameters

hash

string

Returns

Promise<any>


getBlockRaw()

getBlockRaw(hash): Promise<number[]>

Defined in: Developer/brk/modules/brk-client/index.js:9569

Raw block

Returns the raw block data in binary format.

Mempool.space docs

Endpoint: GET /api/block/{hash}/raw

Parameters

hash

string

Returns

Promise<number[]>


getBlockRewards()

getBlockRewards(time_period): Promise<BlockRewardsEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10378

Block rewards

Get average block rewards (coinbase = subsidy + fees) for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/blocks/rewards/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<BlockRewardsEntry[]>


getBlocks()

getBlocks(): Promise<BlockInfo[]>

Defined in: Developer/brk/modules/brk-client/index.js:9665

Recent blocks

Retrieve the last 10 blocks. Returns block metadata for each block.

Mempool.space docs

Endpoint: GET /api/blocks

Returns

Promise<BlockInfo[]>


getBlocksFromHeight()

getBlocksFromHeight(height): Promise<BlockInfo[]>

Defined in: Developer/brk/modules/brk-client/index.js:9709

Blocks from height

Retrieve up to 10 blocks going backwards from the given height. For example, height=100 returns blocks 100, 99, 98, ..., 91. Height=0 returns only block 0.

Mempool.space docs

Endpoint: GET /api/blocks/{height}

Parameters

height

number

Returns

Promise<BlockInfo[]>


getBlockSizesWeights()

getBlockSizesWeights(time_period): Promise<BlockSizesWeights>

Defined in: Developer/brk/modules/brk-client/index.js:10394

Block sizes and weights

Get average block sizes and weights for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/blocks/sizes-weights/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<BlockSizesWeights>


getBlockStatus()

getBlockStatus(hash): Promise<BlockStatus>

Defined in: Developer/brk/modules/brk-client/index.js:9585

Block status

Retrieve the status of a block. Returns whether the block is in the best chain and, if so, its height and the hash of the next block.

Mempool.space docs

Endpoint: GET /api/block/{hash}/status

Parameters

hash

string

Returns

Promise<BlockStatus>


getBlocksV1()

getBlocksV1(): Promise<BlockInfoV1[]>

Defined in: Developer/brk/modules/brk-client/index.js:10222

Recent blocks with extras

Retrieve the last 10 blocks with extended data including pool identification and fee statistics.

Mempool.space docs

Endpoint: GET /api/v1/blocks

Returns

Promise<BlockInfoV1[]>


getBlocksV1FromHeight()

getBlocksV1FromHeight(height): Promise<BlockInfoV1[]>

Defined in: Developer/brk/modules/brk-client/index.js:10238

Blocks from height with extras

Retrieve up to 10 blocks with extended data going backwards from the given height.

Mempool.space docs

Endpoint: GET /api/v1/blocks/{height}

Parameters

height

number

Returns

Promise<BlockInfoV1[]>


getBlockTipHash()

getBlockTipHash(): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:9679

Block tip hash

Returns the hash of the last block.

Mempool.space docs

Endpoint: GET /api/blocks/tip/hash

Returns

Promise<any>


getBlockTipHeight()

getBlockTipHeight(): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:9693

Block tip height

Returns the height of the last block.

Mempool.space docs

Endpoint: GET /api/blocks/tip/height

Returns

Promise<any>


getBlockTxid()

getBlockTxid(hash, index): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:9602

Transaction ID at index

Retrieve a single transaction ID at a specific index within a block. Returns plain text txid.

Mempool.space docs

Endpoint: GET /api/block/{hash}/txid/{index}

Parameters

hash

string

Bitcoin block hash

index

number

Transaction index within the block (0-based)

Returns

Promise<any>


getBlockTxids()

getBlockTxids(hash): Promise<string[]>

Defined in: Developer/brk/modules/brk-client/index.js:9618

Block transaction IDs

Retrieve all transaction IDs in a block. Returns an array of txids in block order.

Mempool.space docs

Endpoint: GET /api/block/{hash}/txids

Parameters

hash

string

Returns

Promise<string[]>


getBlockTxs()

getBlockTxs(hash): Promise<Transaction[]>

Defined in: Developer/brk/modules/brk-client/index.js:9634

Block transactions

Retrieve transactions in a block by block hash. Returns up to 25 transactions starting from index 0.

Mempool.space docs

Endpoint: GET /api/block/{hash}/txs

Parameters

hash

string

Returns

Promise<Transaction[]>


getBlockTxsFromIndex()

getBlockTxsFromIndex(hash, start_index): Promise<Transaction[]>

Defined in: Developer/brk/modules/brk-client/index.js:9651

Block transactions (paginated)

Retrieve transactions in a block by block hash, starting from the specified index. Returns up to 25 transactions at a time.

Mempool.space docs

Endpoint: GET /api/block/{hash}/txs/{start_index}

Parameters

hash

string

Bitcoin block hash

start_index

number

Starting transaction index within the block (0-based)

Returns

Promise<Transaction[]>


getBlockV1()

getBlockV1(hash): Promise<BlockInfoV1>

Defined in: Developer/brk/modules/brk-client/index.js:10208

Block (v1)

Returns block details with extras by hash.

Mempool.space docs

Endpoint: GET /api/v1/block/{hash}

Parameters

hash

string

Returns

Promise<BlockInfoV1>


getCostBasis()

getCostBasis(cohort, date, bucket?, value?): Promise<Object>

Defined in: Developer/brk/modules/brk-client/index.js:9853

Cost basis distribution

Get the cost basis distribution for a cohort on a specific date.

Query params:

  • bucket: raw (default), lin200, lin500, lin1000, log10, log50, log100
  • value: supply (default, in BTC), realized (USD), unrealized (USD)

Endpoint: GET /api/series/cost-basis/{cohort}/{date}

Parameters

cohort

string

date

string

bucket?

CostBasisBucket

Bucket type for aggregation. Default: raw (no aggregation).

value?

CostBasisValue

Value type to return. Default: supply.

Returns

Promise<Object>


getCostBasisCohorts()

getCostBasisCohorts(): Promise<string[]>

Defined in: Developer/brk/modules/brk-client/index.js:9818

Available cost basis cohorts

List available cohorts for cost basis distribution.

Endpoint: GET /api/series/cost-basis

Returns

Promise<string[]>


getCostBasisDates()

getCostBasisDates(cohort): Promise<number[]>

Defined in: Developer/brk/modules/brk-client/index.js:9832

Available cost basis dates

List available dates for a cohort's cost basis distribution.

Endpoint: GET /api/series/cost-basis/{cohort}/dates

Parameters

cohort

string

Returns

Promise<number[]>


getCpfp()

getCpfp(txid): Promise<CpfpInfo>

Defined in: Developer/brk/modules/brk-client/index.js:10254

CPFP info

Returns ancestors and descendants for a CPFP transaction.

Mempool.space docs

Endpoint: GET /api/v1/cpfp/{txid}

Parameters

txid

string

Returns

Promise<CpfpInfo>


getDifficultyAdjustment()

getDifficultyAdjustment(): Promise<DifficultyAdjustment>

Defined in: Developer/brk/modules/brk-client/index.js:10268

Difficulty adjustment

Get current difficulty adjustment progress and estimates.

Mempool.space docs

Endpoint: GET /api/v1/difficulty-adjustment

Returns

Promise<DifficultyAdjustment>


getDifficultyAdjustments()

getDifficultyAdjustments(): Promise<DifficultyAdjustmentEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10424

Difficulty adjustments (all time)

Get historical difficulty adjustments including timestamp, block height, difficulty value, and percentage change.

Mempool.space docs

Endpoint: GET /api/v1/mining/difficulty-adjustments

Returns

Promise<DifficultyAdjustmentEntry[]>


getDifficultyAdjustmentsByPeriod()

getDifficultyAdjustmentsByPeriod(time_period): Promise<DifficultyAdjustmentEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10440

Difficulty adjustments

Get historical difficulty adjustments for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y.

Mempool.space docs

Endpoint: GET /api/v1/mining/difficulty-adjustments/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<DifficultyAdjustmentEntry[]>


getDiskUsage()

getDiskUsage(): Promise<DiskUsage>

Defined in: Developer/brk/modules/brk-client/index.js:10051

Disk usage

Returns the disk space used by BRK and Bitcoin data.

Endpoint: GET /api/server/disk

Returns

Promise<DiskUsage>


getHashrate()

getHashrate(): Promise<HashrateSummary>

Defined in: Developer/brk/modules/brk-client/index.js:10454

Network hashrate (all time)

Get network hashrate and difficulty data for all time.

Mempool.space docs

Endpoint: GET /api/v1/mining/hashrate

Returns

Promise<HashrateSummary>


getHashrateByPeriod()

getHashrateByPeriod(time_period): Promise<HashrateSummary>

Defined in: Developer/brk/modules/brk-client/index.js:10500

Network hashrate

Get network hashrate and difficulty data for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/hashrate/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<HashrateSummary>


getHealth()

getHealth(): Promise<Health>

Defined in: Developer/brk/modules/brk-client/index.js:10667

Health check

Returns the health status of the API server, including uptime information.

Endpoint: GET /health

Returns

Promise<Health>


getHistoricalPrice()

getHistoricalPrice(timestamp?): Promise<HistoricalPrice>

Defined in: Developer/brk/modules/brk-client/index.js:10326

Historical price

Get historical BTC/USD price. Optionally specify a UNIX timestamp to get the price at that time.

Mempool.space docs

Endpoint: GET /api/v1/historical-price

Parameters

timestamp?

number

Returns

Promise<HistoricalPrice>


getIndexes()

getIndexes(): Promise<IndexInfo[]>

Defined in: Developer/brk/modules/brk-client/index.js:9882

List available indexes

Returns all available indexes with their accepted query aliases. Use any alias when querying series.

Endpoint: GET /api/series/indexes

Returns

Promise<IndexInfo[]>


getJson()

getJson<T>(path, onUpdate?): Promise<T>

Defined in: Developer/brk/modules/brk-client/index.js:1533

Make a GET request - races cache vs network, first to resolve calls onUpdate

Type Parameters

T

T

Parameters

path

string

onUpdate?

(value) => void

Called when data is available (may be called twice: cache then network)

Returns

Promise<T>

Inherited from

BrkClientBase.getJson


getLivePrice()

getLivePrice(): Promise<number>

Defined in: Developer/brk/modules/brk-client/index.js:9735

Live BTC/USD price

Returns the current BTC/USD price in dollars, derived from on-chain round-dollar output patterns in the last 12 blocks plus mempool.

Endpoint: GET /api/mempool/price

Returns

Promise<number>


getMempool()

getMempool(): Promise<MempoolInfo>

Defined in: Developer/brk/modules/brk-client/index.js:9723

Mempool statistics

Get current mempool statistics including transaction count, total vsize, total fees, and fee histogram.

Mempool.space docs

Endpoint: GET /api/mempool

Returns

Promise<MempoolInfo>


getMempoolBlocks()

getMempoolBlocks(): Promise<MempoolBlock[]>

Defined in: Developer/brk/modules/brk-client/index.js:10282

Projected mempool blocks

Get projected blocks from the mempool for fee estimation.

Mempool.space docs

Endpoint: GET /api/v1/fees/mempool-blocks

Returns

Promise<MempoolBlock[]>


getMempoolRecent()

getMempoolRecent(): Promise<MempoolRecentTx[]>

Defined in: Developer/brk/modules/brk-client/index.js:9749

Recent mempool transactions

Get the last 10 transactions to enter the mempool.

Mempool.space docs

Endpoint: GET /api/mempool/recent

Returns

Promise<MempoolRecentTx[]>


getMempoolTxids()

getMempoolTxids(): Promise<string[]>

Defined in: Developer/brk/modules/brk-client/index.js:9763

Mempool transaction IDs

Get all transaction IDs currently in the mempool.

Mempool.space docs

Endpoint: GET /api/mempool/txids

Returns

Promise<string[]>


getOpenapi()

getOpenapi(): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:10679

OpenAPI specification

Full OpenAPI 3.1 specification for this API.

Endpoint: GET /openapi.json

Returns

Promise<any>


getPool()

getPool(slug): Promise<PoolDetail>

Defined in: Developer/brk/modules/brk-client/index.js:10516

Mining pool details

Get detailed information about a specific mining pool including block counts and shares for different time periods.

Mempool.space docs

Endpoint: GET /api/v1/mining/pool/{slug}

Parameters

slug

PoolSlug

Returns

Promise<PoolDetail>


getPoolBlocks()

getPoolBlocks(slug): Promise<BlockInfoV1[]>

Defined in: Developer/brk/modules/brk-client/index.js:10532

Mining pool blocks

Get the 10 most recent blocks mined by a specific pool.

Mempool.space docs

Endpoint: GET /api/v1/mining/pool/{slug}/blocks

Parameters

slug

PoolSlug

Returns

Promise<BlockInfoV1[]>


getPoolBlocksFrom()

getPoolBlocksFrom(slug, height): Promise<BlockInfoV1[]>

Defined in: Developer/brk/modules/brk-client/index.js:10549

Mining pool blocks from height

Get 10 blocks mined by a specific pool before (and including) the given height.

Mempool.space docs

Endpoint: GET /api/v1/mining/pool/{slug}/blocks/{height}

Parameters

slug

PoolSlug

height

number

Returns

Promise<BlockInfoV1[]>


getPoolHashrate()

getPoolHashrate(slug): Promise<PoolHashrateEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10565

Mining pool hashrate

Get hashrate history for a specific mining pool.

Mempool.space docs

Endpoint: GET /api/v1/mining/pool/{slug}/hashrate

Parameters

slug

PoolSlug

Returns

Promise<PoolHashrateEntry[]>


getPools()

getPools(): Promise<PoolInfo[]>

Defined in: Developer/brk/modules/brk-client/index.js:10579

List all mining pools

Get list of all known mining pools with their identifiers.

Mempool.space docs

Endpoint: GET /api/v1/mining/pools

Returns

Promise<PoolInfo[]>


getPoolsHashrate()

getPoolsHashrate(): Promise<PoolHashrateEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10468

All pools hashrate (all time)

Get hashrate data for all mining pools.

Mempool.space docs

Endpoint: GET /api/v1/mining/hashrate/pools

Returns

Promise<PoolHashrateEntry[]>


getPoolsHashrateByPeriod()

getPoolsHashrateByPeriod(time_period): Promise<PoolHashrateEntry[]>

Defined in: Developer/brk/modules/brk-client/index.js:10484

All pools hashrate

Get hashrate data for all mining pools for a time period. Valid periods: 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/hashrate/pools/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<PoolHashrateEntry[]>


getPoolStats()

getPoolStats(time_period): Promise<PoolsSummary>

Defined in: Developer/brk/modules/brk-client/index.js:10595

Mining pool statistics

Get mining pool statistics for a time period. Valid periods: 24h, 3d, 1w, 1m, 3m, 6m, 1y, 2y, 3y

Mempool.space docs

Endpoint: GET /api/v1/mining/pools/{time_period}

Parameters

time_period

TimePeriod

Returns

Promise<PoolsSummary>


getPreciseFees()

getPreciseFees(): Promise<RecommendedFees>

Defined in: Developer/brk/modules/brk-client/index.js:10296

Precise recommended fees

Get recommended fee rates with up to 3 decimal places.

Mempool.space docs

Endpoint: GET /api/v1/fees/precise

Returns

Promise<RecommendedFees>


getPrices()

getPrices(): Promise<Prices>

Defined in: Developer/brk/modules/brk-client/index.js:10625

Current BTC price

Returns bitcoin latest price (on-chain derived, USD only).

Mempool.space docs

Endpoint: GET /api/v1/prices

Returns

Promise<Prices>


getRecommendedFees()

getRecommendedFees(): Promise<RecommendedFees>

Defined in: Developer/brk/modules/brk-client/index.js:10310

Recommended fees

Get recommended fee rates for different confirmation targets.

Mempool.space docs

Endpoint: GET /api/v1/fees/recommended

Returns

Promise<RecommendedFees>


getRewardStats()

getRewardStats(block_count): Promise<RewardStats>

Defined in: Developer/brk/modules/brk-client/index.js:10611

Mining reward statistics

Get mining reward statistics for the last N blocks including total rewards, fees, and transaction count.

Mempool.space docs

Endpoint: GET /api/v1/mining/reward-stats/{block_count}

Parameters

block_count

number

Number of recent blocks to include

Returns

Promise<RewardStats>


getSeries()

getSeries(series, index, start?, end?, limit?, format?): Promise<string | AnySeriesData>

Defined in: Developer/brk/modules/brk-client/index.js:9955

Get series data

Fetch data for a specific series at the given index. Use query parameters to filter by date range and format (json/csv).

Endpoint: GET /api/series/{series}/{index}

Parameters

series

string

Series name

index

Index

Aggregation index

start?

number

Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: from, f, s

end?

number

Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: to, t, e

limit?

number

Maximum number of values to return (ignored if end is set). Aliases: count, c, l

format?

Format

Format of the output

Returns

Promise<string | AnySeriesData>


getSeriesBulk()

getSeriesBulk(series?, index?, start?, end?, limit?, format?): Promise<string | AnySeriesData[]>

Defined in: Developer/brk/modules/brk-client/index.js:9794

Bulk series data

Fetch multiple series in a single request. Supports filtering by index and date range. Returns an array of SeriesData objects. For a single series, use get_series instead.

Endpoint: GET /api/series/bulk

Parameters

series?

string

Requested series

index?

Index

Index to query

start?

number

Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: from, f, s

end?

number

Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: to, t, e

limit?

number

Maximum number of values to return (ignored if end is set). Aliases: count, c, l

format?

Format

Format of the output

Returns

Promise<string | AnySeriesData[]>


getSeriesCount()

getSeriesCount(): Promise<SeriesCount[]>

Defined in: Developer/brk/modules/brk-client/index.js:9870

Series count

Returns the number of series available per index type.

Endpoint: GET /api/series/count

Returns

Promise<SeriesCount[]>


getSeriesData()

getSeriesData(series, index, start?, end?, limit?, format?): Promise<string | boolean[]>

Defined in: Developer/brk/modules/brk-client/index.js:9984

Get raw series data

Returns just the data array without the SeriesData wrapper. Supports the same range and format parameters as the standard endpoint.

Endpoint: GET /api/series/{series}/{index}/data

Parameters

series

string

Series name

index

Index

Aggregation index

start?

number

Inclusive start: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: from, f, s

end?

number

Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: to, t, e

limit?

number

Maximum number of values to return (ignored if end is set). Aliases: count, c, l

format?

Format

Format of the output

Returns

Promise<string | boolean[]>


getSeriesInfo()

getSeriesInfo(series): Promise<SeriesInfo>

Defined in: Developer/brk/modules/brk-client/index.js:9936

Get series info

Returns the supported indexes and value type for the specified series.

Endpoint: GET /api/series/{series}

Parameters

series

string

Returns

Promise<SeriesInfo>


getSeriesLatest()

getSeriesLatest(series, index): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:10009

Get latest series value

Returns the single most recent value for a series, unwrapped (not inside a SeriesData object).

Endpoint: GET /api/series/{series}/{index}/latest

Parameters

series

string

Series name

index

Index

Aggregation index

Returns

Promise<any>


getSeriesLen()

getSeriesLen(series, index): Promise<number>

Defined in: Developer/brk/modules/brk-client/index.js:10024

Get series data length

Returns the total number of data points for a series at the given index.

Endpoint: GET /api/series/{series}/{index}/len

Parameters

series

string

Series name

index

Index

Aggregation index

Returns

Promise<number>


getSeriesTree()

getSeriesTree(): Promise<TreeNode>

Defined in: Developer/brk/modules/brk-client/index.js:9775

Series catalog

Returns the complete hierarchical catalog of available series organized as a tree structure. Series are grouped by categories and subcategories.

Endpoint: GET /api/series

Returns

Promise<TreeNode>


getSeriesVersion()

getSeriesVersion(series, index): Promise<number>

Defined in: Developer/brk/modules/brk-client/index.js:10039

Get series version

Returns the current version of a series. Changes when the series data is updated.

Endpoint: GET /api/series/{series}/{index}/version

Parameters

series

string

Series name

index

Index

Aggregation index

Returns

Promise<number>


getSyncStatus()

getSyncStatus(): Promise<SyncStatus>

Defined in: Developer/brk/modules/brk-client/index.js:10063

Sync status

Returns the sync status of the indexer, including indexed height, tip height, blocks behind, and last indexed timestamp.

Endpoint: GET /api/server/sync

Returns

Promise<SyncStatus>


getText()

getText(path): Promise<string>

Defined in: Developer/brk/modules/brk-client/index.js:1587

Make a GET request and return raw text (for CSV responses)

Parameters

path

string

Returns

Promise<string>

Inherited from

BrkClientBase.getText


getTransactionTimes()

getTransactionTimes(): Promise<number[]>

Defined in: Developer/brk/modules/brk-client/index.js:10639

Transaction first-seen times

Returns timestamps when transactions were first seen in the mempool. Returns 0 for mined or unknown transactions.

Mempool.space docs

Endpoint: GET /api/v1/transaction-times

Returns

Promise<number[]>


getTx()

getTx(txid): Promise<Transaction>

Defined in: Developer/brk/modules/brk-client/index.js:10079

Transaction information

Retrieve complete transaction data by transaction ID (txid). Returns inputs, outputs, fee, size, and confirmation status.

Mempool.space docs

Endpoint: GET /api/tx/{txid}

Parameters

txid

string

Returns

Promise<Transaction>


getTxHex()

getTxHex(txid): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:10095

Transaction hex

Retrieve the raw transaction as a hex-encoded string. Returns the serialized transaction in hexadecimal format.

Mempool.space docs

Endpoint: GET /api/tx/{txid}/hex

Parameters

txid

string

Returns

Promise<any>


getTxMerkleblockProof()

getTxMerkleblockProof(txid): Promise<any>

Defined in: Developer/brk/modules/brk-client/index.js:10127

Transaction merkleblock proof

Get the merkleblock proof for a transaction (BIP37 format, hex encoded).

Mempool.space docs

Endpoint: GET /api/tx/{txid}/merkleblock-proof

Parameters

txid

string

Returns

Promise<any>


getTxMerkleProof()

getTxMerkleProof(txid): Promise<MerkleProof>

Defined in: Developer/brk/modules/brk-client/index.js:10111

Transaction merkle proof

Get the merkle inclusion proof for a transaction.

Mempool.space docs

Endpoint: GET /api/tx/{txid}/merkle-proof

Parameters

txid

string

Returns

Promise<MerkleProof>


getTxOutspend()

getTxOutspend(txid, vout): Promise<TxOutspend>

Defined in: Developer/brk/modules/brk-client/index.js:10144

Output spend status

Get the spending status of a transaction output. Returns whether the output has been spent and, if so, the spending transaction details.

Mempool.space docs

Endpoint: GET /api/tx/{txid}/outspend/{vout}

Parameters

txid

string

Transaction ID

vout

number

Output index

Returns

Promise<TxOutspend>


getTxOutspends()

getTxOutspends(txid): Promise<TxOutspend[]>

Defined in: Developer/brk/modules/brk-client/index.js:10160

All output spend statuses

Get the spending status of all outputs in a transaction. Returns an array with the spend status for each output.

Mempool.space docs

Endpoint: GET /api/tx/{txid}/outspends

Parameters

txid

string

Returns

Promise<TxOutspend[]>


getTxRaw()

getTxRaw(txid): Promise<number[]>

Defined in: Developer/brk/modules/brk-client/index.js:10176

Transaction raw

Returns a transaction as binary data.

Mempool.space docs

Endpoint: GET /api/tx/{txid}/raw

Parameters

txid

string

Returns

Promise<number[]>


getTxStatus()

getTxStatus(txid): Promise<TxStatus>

Defined in: Developer/brk/modules/brk-client/index.js:10192

Transaction status

Retrieve the confirmation status of a transaction. Returns whether the transaction is confirmed and, if so, the block height, hash, and timestamp.

Mempool.space docs

Endpoint: GET /api/tx/{txid}/status

Parameters

txid

string

Returns

Promise<TxStatus>


getVersion()

getVersion(): Promise<string>

Defined in: Developer/brk/modules/brk-client/index.js:10691

API version

Returns the current version of the API server

Endpoint: GET /version

Returns

Promise<string>


indexToDate()

indexToDate(index, i): Date

Defined in: Developer/brk/modules/brk-client/index.js:7707

Convert an index value to a Date for date-based indexes.

Parameters

index

Index

The index type

i

number

The index value

Returns

Date


listSeries()

listSeries(page?, per_page?): Promise<PaginatedSeries>

Defined in: Developer/brk/modules/brk-client/index.js:9897

Series list

Paginated flat list of all available series names. Use page query param for pagination.

Endpoint: GET /api/series/list

Parameters

page?

number

Pagination index

per_page?

number

Results per page (default: 1000, max: 1000)

Returns

Promise<PaginatedSeries>


searchSeries()

searchSeries(q?, limit?): Promise<string[]>

Defined in: Developer/brk/modules/brk-client/index.js:9917

Search series

Fuzzy search for series by name. Supports partial matches and typos.

Endpoint: GET /api/series/search

Parameters

q?

string

Search query string

limit?

number

Maximum number of results

Returns

Promise<string[]>


seriesEndpoint()

seriesEndpoint(series, index): SeriesEndpoint<unknown>

Defined in: Developer/brk/modules/brk-client/index.js:9403

Create a dynamic series endpoint builder for any series/index combination.

Use this for programmatic access when the series name is determined at runtime. For type-safe access, use the series tree instead.

Parameters

series

string

The series name

index

Index

The index name

Returns

SeriesEndpoint<unknown>


validateAddress()

validateAddress(address): Promise<AddrValidation>

Defined in: Developer/brk/modules/brk-client/index.js:10655

Validate address

Validate a Bitcoin address and get information about its type and scriptPubKey.

Mempool.space docs

Endpoint: GET /api/v1/validate-address/{address}

Parameters

address

string

Bitcoin address to validate (can be any string)

Returns

Promise<AddrValidation>