How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Braiins Hashpower API

Public HTTP API for the Braiins Hashpower marketplace: buying hashrate on the spot market, scheduling fixed-duration contracts with guaranteed delivery, and reading account and market data. 35 operations across bid orders, contracts, accounts, market data and market configuration, published as OpenAPI 3.1.0 and rendered in Scalar at https://hashpower.braiins.com/api. Authentication is an API key in the apikey header, scoped by ACL role (owner for trading, read-only for viewing); the four market-data operations are callable anonymously. Every operation publishes its own rate limit in the contract. Notable for two advisory operations — quoteContractCreation and checkContractSpeedAvailability — that let a caller cost and validate a contract without reserving funds or capacity. Braiins labels Hashpower a beta product and the 0% spot bid fee is stated to apply during the beta period.

Braiins Hashpower API is one of 3 APIs that Braiins publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Hashrate Marketplace, Bitcoin, Trading, Contracts, and Market Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and pricing.

This API exposes 35 operations across 31 paths, organized into 5 resource areas, and defines 94 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://hashpower.braiins.com/v1.

35 operations 31 paths 94 schemas 1 DELETE27 GET6 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://hashpower.braiins.com/v1
Authentication
API Key
Resource Areas
5

Authentication & Security 1

Braiins Hashpower API declares 1 security scheme for authenticating requests. An API key is passed in the header as apikey (ApiKey). By default, every request must be authenticated.

  • ApiKey — API credential issued for a Braiins Hashpower account. The credential's ACL role and resource ownership determine which authenticated operations and records ar…

Paths & Operations 35

Across 31 paths, the API surfaces 35 operations — 1 DELETE, 27 GET, 6 POST, 1 PUT. They span 5 resource areas: Market configuration, Bid orders, Contracts, Accounts, Market data. Each is listed below with its method, path, parameters, and response codes.

Market configuration 2

Spot-market rules, units, and fees needed to construct valid orders.

GET
/spot/settings
Retrieve market settings & rules
spotGetMarketSettings → 200401403429default
GET
/spot/fee
Get spot market fee structure
getFeeStructure → 200401403429default
Bid orders 8

Create, update, cancel, and inspect caller-owned spot-market bids.

GET
/spot/bid/current
List user's bids (active)
spotGetCurrentBids → 200401403429default
GET
/spot/bid
List user’s bids (historical & active).
spotGetBids 10 params → 200400401403429default
POST
/spot/bid
Place new bid (buy order) to the market
spotPlaceBid body → 200400401403429default
PUT
/spot/bid
Edit existing bid
spotEditBid body → 200400401403404429default
DELETE
/spot/bid
Cancel existing bid
spotCancelBid body → 200400401403404429default
GET
/spot/bid/detail/{order_id}
Get detailed information for a specific bid
spotGetBidDetail 1 param → 200400401403404429default
GET
/spot/bid/speed/{order_id}
Get bid hashrate history time series
spotGetBidSpeedHistory 5 params → 200400401403404429default
GET
/spot/bid/delivery/{order_id}
Get bid delivery history time series
spotGetBidDeliveryHistory 4 params → 200400401403404429default
Contracts 16

Quote, schedule, manage, and inspect caller-owned fixed-duration contracts.

GET
/contract
List caller-owned contracts
getContracts 6 params → 200400401403429default
POST
/contract
Schedule a new caller-owned contract
scheduleContract body → 200400401403429default
POST
/contract/quote
Quote and validate a contract creation request
quoteContractCreation body → 200400401403429default
GET
/contract/pricing
List current contract pricing
getCurrentContractPricing 1 param → 200400429default
GET
/contract/cancel-fee
List current contract cancellation fees
getCurrentContractCancelFees 1 param → 200400429default
POST
/contract/availability
Check whether requested contract hashrate is available
checkContractSpeedAvailability body → 200400401403429default
GET
/contract/active
List caller-owned pending, running, or paused contracts
getActiveContracts 1 param → 200400401403429default
GET
/contract/{contract_id}/detail
Get a caller-owned contract
getContractDetail 1 param → 200400401403404429default
GET
/contract/settings
Get effective contract policy settings
getContractSettings 1 param → 200400401403429default
POST
/contract/{contract_id}:cancel
Request cancellation for a pending caller-owned contract
cancelContract 1 param body → 200400401403404429default
POST
/contract/{contract_id}:terminate
Terminate an active caller-owned contract
terminateContract 1 param body → 200400401403404429default
GET
/contract/activity
List contract activity for the caller
getContractActivity 2 params → 200400401403429default
GET
/contract/{contract_id}/reservation
List reservation history for a caller-owned contract
getContractReservations 1 param → 200400401403404429default
GET
/contract/{contract_id}/settlement
List settlement history for a caller-owned contract
getContractSettlements 1 param → 200400401403404429default
GET
/contract/{contract_id}/speed
Get contract hashrate history time series
getContractSpeedHistory 5 params → 200400401403404429default
GET
/contract/{contract_id}/delivery
Get contract delivery history time series
getContractDeliveryHistory 4 params → 200400401403404429default
Accounts 5

Read caller-owned balances and accounting transactions.

GET
/account/balance
Get account balance
getAccountBalances → 200401403429default
GET
/account/transactiondeprecated
List mixed account transactions (deprecated)
getTransactions 2 params → 200400401403429default
GET
/account/transaction/settlement
List settlement account transactions
getSettlementTransactions 4 params → 200400401403429default
GET
/account/transaction/lock
List lock account transactions
getLockTransactions 4 params → 200400401403429default
GET
/account/transaction/on-chain
List on-chain account transactions
getOnChainTransactions 2 params → 200400401403429default
Market data 4

Public statistics, order-book snapshots, trades, and OHLCV bars.

GET
/spot/stats
Get market statistics
spotGetMarketStats → 200429default
GET
/spot/orderbook
Get spot market order book snapshot
spotGetOrderbookSnapshot → 200429default
GET
/spot/trades
Get last market trades
spotGetMarketTrades 1 param → 200400429default
GET
/spot/bars
Get aggregated bars for a given market (OHLCV)
spotGetMarketBars 2 params → 200400429default

Schemas 94

The contract defines 94 schemas that model the data the API accepts and returns. The most detailed are MarketSettings (23 properties), SpotMarketBid (22 properties), ContractPublic (22 properties), QuoteContractCreationResponse (15 properties). Each schema is shown below with its type and property counts.

SpotInstrumentStatus
string
MarketSettings
object
23 properties 23 required
ProfileIdentifier
object
2 properties 2 required
ScheduleContractRequest
object
6 properties 5 required
ScheduleContractResponse
object
1 property 1 required
CheckContractSpeedAvailabilityRequest
object
4 properties 4 required
CheckContractSpeedAvailabilityResponse
object
3 properties 3 required
QuoteContractCreationRequest
object
4 properties 4 required
ContractCreationQuoteStatus
string
ContractCreationQuoteReason
string
QuoteContractCreationResponse
object
15 properties 15 required
CurrentContractPricingLayerKind
string
CurrentContractPricingBand
object
2 properties 2 required
CurrentContractPricingLayer
object
5 properties 5 required
GetCurrentContractPricingResponse
object
1 property 1 required
CurrentContractCancelFeeLayerKind
string
CurrentContractCancelFeeLayer
object
5 properties 5 required
GetCurrentContractCancelFeesResponse
object
1 property 1 required
CancelContractRequest
object
1 property
ContractCancellationRequestState
string
ContractCancellationRequest
object
6 properties
CancelContractResponse
object
1 property
TerminateContractRequest
object
1 property
TerminateContractResponse
object
1 property 1 required
GetContractDetailResponse
object
2 properties 2 required
GetContractSettingsResponse
object
8 properties 8 required
GetContractsResponse
object
1 property 1 required
GetContractsResponseItem
object
2 properties 2 required
ContractPublic
object
22 properties 9 required
ContractStatePublic
object
8 properties 8 required
ContractStatus
string
GetContractReservationsResponse
object
2 properties 2 required
ContractReservationPublicItem
object
6 properties 5 required
ContractReservationOriginPublic
string
GetContractSettlementsResponse
object
2 properties 2 required
ContractSettlementPublicItem
object
10 properties 8 required
ContractActivityType
string
ContractActivityItem
object
8 properties 8 required
GetContractActivityResponse
object
3 properties 3 required
ContractDestination
LocalContractDestination
object
1 property 1 required
UpstreamContractDestination
object
1 property 1 required
SpotGetBidsResponse
object
1 property 1 required
SpotGetBidsResponseItem
object
5 properties 4 required
SpotGetBidDetailResponse
object
6 properties 4 required
SpotMarketBid
object
22 properties 18 required
SpotMarketBidStatus
string
Common status values used for multiple client management entities
SpotMarketBidCounters
object
5 properties 5 required
SpotMarketBidState
object
3 properties 3 required
UpstreamFailure
object
3 properties 3 required
SpotBidHistoryItem
object
7 properties 7 required
UpstreamSpecification
object
2 properties 2 required
SpotPlaceBidRequest
object
6 properties 3 required
PlaceOrderResponse
object
2 properties 2 required
SpotEditBidRequest
object
6 properties
SpotCancelBidRequest
object
Identifies the caller-owned bid to cancel by its public or client-assigned ID.
2 properties
CancelResponse
object
IDs affected by the operation (canceled successfully).
1 property 1 required
MultipleStringIds
object
1 property 1 required
GetFeeStructureResponse
object
1 property 1 required
SpotFeePublic
object
3 properties 3 required
SpotMarketFeeType
string
SPOTFEETYPEUNSPECIFIED SPOTFEETYPEBUY - Continuous spot buy fee. Only percentagefeerate is used. SPOTFEETYPESELL - Continuous spot sell fee. Only percentagefee…
FeeSpec
object
Generic fee specification. Allows to specify a fee w/ percents for now.
1 property 1 required
GetAccountBalancesResponse
object
1 property 1 required
AccountBalance
object
14 properties 14 required
GetTransactionsResponse
object
1 property 1 required
GetOnChainTransactionsResponse
object
1 property 1 required
Transaction
object
4 properties 4 required
OnChainTransaction
object
8 properties 4 required
OnChainTransactionType
integer
On-chain transaction type.
DepositStatus
integer
Deposit status (deposit transactions only).
SpotGetMarketStatsResponse
object
7 properties 7 required
SpotGetOrderBookResponse
object
2 properties 2 required
BidItem
object
5 properties 4 required
AskItem
object
3 properties 3 required
Int32
integer
Int64
integer
Uint32
integer
Double
number
OptionalDouble
object
Optional double value.
1 property
SpotGetMarketTradesResponse
object
1 property 1 required
TradeSha256Btc
object
3 properties 3 required
AggregationPeriod
string
Aggregation period for bars (OHLCV candles).
ContractHistoryAggregationPeriod
string
Aggregation period for contract history time series.
SlidingWindowSize
string
Sliding window size for estimating hashrate.
SpotGetBarsResponse
object
1 property 1 required
TradeBar
object
7 properties 7 required
SpotGetOrderSpeedHistoryResponse
object
1 property 1 required
SpotGetOrderSpeedHistoryItem
object
2 properties 2 required
SpotGetBidDeliveryHistoryResponse
object
1 property 1 required
SpotBidDeliveryHistoryItem
object
4 properties 4 required
GetContractSpeedHistoryResponse
object
1 property 1 required
GetContractSpeedHistoryItem
object
2 properties 2 required
GetContractDeliveryHistoryResponse
object
1 property 1 required
GetContractDeliveryHistoryItem
object
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

braiins-academy-braiins-hashpower-openapi.yml Raw ↑

Other APIs Braiins publishes across the network.

Braiins OS Public API
Braiins Pool API
Where this information came from

This is an independent, third-party profile of Braiins Hashpower API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.