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

Bullish Idb API

The Inter-dealer Broker (IDB) API is available to authorized inter-dealer brokers to book OTC trades on Bullish on behalf of their respective end customers.

Bullish Idb API is one of 32 APIs that Bullish publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include idb. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog.

This API exposes 5 operations across 5 paths, and defines 32 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 7 base URLs: https://api.exchange.bullish.com/trading-api, https://registered.api.exchange.bullish.com/trading-api, https://prod.access.bullish.com/trading-api, https://api.bugbounty.bullish.com/trading-api, https://api.simnext.bullish-test.com/trading-api, https://registered.api.simnext.bullish-test.com/trading-api, https://simnext.access.bullish.com/trading-api.

5 operations 5 paths 32 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.exchange.bullish.com/trading-api
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Bullish Idb API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (jwtTokenAuth).

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

idb 5

The Inter-dealer Broker (IDB) API is available to authorized inter-dealer brokers to book OTC trades on Bullish on behalf of their respective end customers.

GET
/v2/idb/delegated-accounts
IDB Get Delegated Trading Accounts
idb-otc-get-delegated-accounts 1 param → 200401403500
POST
/v2/idb/otc-trades
IDB Create OTC Trade
idb-otc-create-trade 3 params body → 200400401403500
GET
/v2/idb/otc-trades#list
IDB Get OTC Trades
idb-otc-get-trades 5 params → 200400401403500
POST
/v2/idb/otc-command#cancel
IDB Cancel OTC Trade
idb-otc-command-cancel 3 params body → 200400401403500
POST
/v2/idb/otc-command#update-remarks
IDB Update Remarks
idb-otc-command-update-remarks 3 params body → 200400401403500

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are IdbOtcTradeView (16 properties), IdbOtcTradeLegView (11 properties), IdbCreateOtcTradeCommand (5 properties), IdbDelegatedAccountView (5 properties). Each schema is shown below with its type and property counts.

IdbUpdateRemarksResponse
object
A response for an acknowledged OTC command to update IDB remarks of a dual-sided OTC trade
4 properties 4 required
OtcTradeExternalStatus
string
OTC trade status
TradeID
string
IdbOtcTradeLegView
object
a trade leg of a brokered OTC trade
11 properties 5 required
IdbCancelOtcTradeResponse
object
A response for an acknowledged OTC command to cancel a dual-sided OTC trade
4 properties 4 required
TimeStampAsString
string
unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
SharedMatchKey
string
Unique shared key that is agreed between the two customers to represent their OTC trade to be matched on Bullish's OTC Clearing Facility. Must be a 12 to 64 ch…
DelegatedInstitutionName
string
legal name of the institution that owns the delegated trading account
TradeSideAsString
string
trade side can have the following string values BUY, SELL
TradingAccountId
string
unique trading account ID
IdbCancelOtcTradeCommand
object
A command to cancel a dual-sided OTC trade using sharedMatchKey
3 properties 2 required
IdbUpdateRemarksCommand
object
A command to update IDB remarks of a dual-sided OTC trade using sharedMatchKey
3 properties 3 required
Boolean
boolean
IdbOtcTradeView
object
16 properties 14 required
RequestID
string
DateTime
string
ISO 8601 with millisecond as string
DelegatedInstitutionRegistrationNumber
stringnull
registration number of the institution that owns the delegated trading account. Nullable and omitted from the response when the institution has no registration…
AssetValue
string
see [asset value](/rest/general/price-quantity-precision) format
DelegatedApprovalMethod
string
The default execution workflow for this IDB-Client pair: - STRAIGHTTHROUGH: Trades are processed automatically - APPROVALREQUIRED: Every trade requires manual…
IdbCreateOtcTradeResponse
object
A response for an acknowledged dual-sided brokered OTC trade creation request
4 properties 4 required
TradeInOtcRequest
object
A trade of an OTC trade
4 properties 4 required
OtcTradeId
string
unique numeric (i64) identifier generated on Bullish side expressed as a string value
IdbShortCode
string
broker short code
Remarks
string
text field for client's internal reference to a trade, max length is 255 characters
DelegatedTradingAccountNickname
string
nickname assigned for this account
OtcMarketSymbol
string
market symbol. E.g. BTC-USDC-PERP for PERPETUAL market BTC-USDC-20250613 for DATEDFUTURE market and BTC-USDC-20250613-100000-C for OPTION market
IdbRequestItem
object
2 properties
IdbCreateOtcTradeCommand
object
A single command with details for both the maker and taker legs of a brokered OTC trade
5 properties 4 required
BadOtcTradeEntryResponse
object
3 properties 3 required
IdbRemarks
string
text field for IDB's internal reference to a trade, max length is 255 characters
IdbDelegatedAccountView
object
Details of delegated accounts from the broker perspective.
5 properties 4 required
BrokeredTradeSide
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bullish-idb-api-openapi.yml Raw ↑

Other APIs Bullish publishes across the network.

Bullish Deprecated Features and APIs
Bullish WebSocket Multi-Order Book API
Bullish WebSocket Anonymous Trades API
Bullish WebSocket Anonymous Ticks API
Bullish WebSocket Auction Feed API
Bullish WebSocket Index Data API
Bullish WebSocket Private Data API
Bullish FIX API
Bullish Aggregator API
Bullish Account Assets API
Bullish Amm Instructions API
Bullish Asset Data API
Where this information came from

This is an independent, third-party profile of Bullish Idb 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.