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 Otc API

The OTC Clearing Facility API (OTC API) is available to customers to book trades negotiated outside of the Bullish Exchange order book to Bullish's clearing and settlement platform. Customers may agree to an OTC transaction through bilateral negotiations or via a 3rd party RFQ platform. Once the two customers agree on the trade details, they can use the OTC API to book the trade to their Bullish account to benefit from Bullish's risk and collateral management system. For purposes of clarity, the OTC API is not for trading purposes.

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

Tagged areas include OTC. 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 7 operations across 6 paths, and defines 30 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.

7 operations 6 paths 30 schemas 4 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 Otc API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (jwtTokenAuth).

Paths & Operations 7

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

otc 7

The OTC Clearing Facility API (OTC API) is available to customers to book trades negotiated outside of the Bullish Exchange order book to Bullish's clearing and settlement platfor…

POST
/v2/otc-trades
Create OTC Trade
createOtcTrade 4 params body → 200400401403500
GET
/v2/otc-trades
Get OTC Trades
getOtcTrades 7 params → 200400401403500
GET
/v2/otc-trades/{otcTradeId}
Get OTC Trade by ID
getOtcTradeById 2 params → 200400401403404500
GET
/v2/otc-trades/unconfirmed-trade
Get Unconfirmed OTC Trade
getUnconfirmedOtcTrade 2 params → 200400401403404500
POST
/v2/otc-command#approve
Approve OTC Trade
otc-command-approve 3 params body → 200400401403500
POST
/v2/otc-command#cancel
Cancel OTC Trade
otc-command-cancel 3 params body → 200400401403500
GET
/v2/otc-trades/delegated-accounts
Get Delegated Trading Accounts
otc-get-delegated-accounts → 200401403500

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are OtcTradeView (15 properties), OtcTradeLegView (13 properties), UnconfirmedOtcTradeView (7 properties), CreateOtcTradeCommand (7 properties). Each schema is shown below with its type and property counts.

ClientDelegatedAccountView
object
Details of a trading account delegated to an inter-dealer broker, from the client perspective.
4 properties 2 required
OtcTradeExternalStatus
string
OTC trade status
TradeID
string
CancelOtcTradeResponse
object
A response for an acknowledged OTC command to cancel an OTC trade
5 properties 4 required
CancelOtcTradeCommand
object
A command to cancel an OTC trade. Only one of clientOtcTradeId or otcTradeId can be used in the cancel OTC trade command
4 properties 2 required
OtcTradeLegView
object
a trade of an OTC trade
13 properties 5 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…
ApproveOtcTradeCommand
object
A command to approve an OTC trade. Only one of clientOtcTradeId or otcTradeId can be used in the approve OTC trade command
4 properties 2 required
TradeSideAsString
string
trade side can have the following string values BUY, SELL
TradingAccountId
string
unique trading account ID
ApproveOtcTradeResponse
object
A response for an acknowledged OTC command to approve an OTC trade
5 properties 4 required
ClientOtcTradeId
string
unique numeric (i64) identifier generated on the client side expressed as a string value
Boolean
boolean
RequestID
string
CancelAllOtcTradesResponse
object
A response for an acknowledged OTC command to cancel all pending OTC trades
3 properties 3 required
DateTime
string
ISO 8601 with millisecond as string
AssetValue
string
see [asset value](/rest/general/price-quantity-precision) format
UnconfirmedOtcTradeView
object
An unconfirmed OTC trade for booking.
7 properties 7 required
DelegatedApprovalMethod
string
The default execution workflow for this IDB-Client pair: - STRAIGHTTHROUGH: Trades are processed automatically - APPROVALREQUIRED: Every trade requires manual…
CreateOtcTradeCommand
object
A command with details to an OTC trade
7 properties 5 required
CancelAllOtcTradesCommand
object
A command to cancel all pending OTC trades.
2 properties 2 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
OtcTradeView
object
15 properties 10 required
Remarks
string
text field for client's internal reference to a trade, max length is 255 characters
IdbShortCode
string
broker short code
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
BadOtcTradeEntryResponse
object
3 properties 3 required
CreateOtcTradeResponse
object
A response for an acknowledged OTC trade creation request
5 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bullish-otc-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 Otc 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.