Bullish API
Overview
The Bullish API provides access to Block RFQ (Request for Quote) trading functionality. This API allows traders to create, manage, and execute block trades through a maker-taker model.
API Structure
The Bullish API consists of two main components:
REST API
The REST API provides synchronous endpoints for:
- Instruments: Query available trading instruments
- Makers: Get list of available block makers
- RFQs: Create, cancel, and query Block RFQs
- Quotes: Create, cancel, and query quotes on RFQs
- Trades: Execute trades and query trade history
WebSocket API
The WebSocket API provides real-time streaming data for:
- Connection Management: Connect and authenticate
- RFQ Updates: Subscribe to RFQ updates for taker and maker roles
- Quote Updates: Subscribe to quote updates
- Trade Updates: Subscribe to trade execution updates
Key Concepts
Block RFQ
A Block RFQ is a request for quote on a block trade, which can include:
- Multiple instrument legs (combo trades)
- Optional hedge leg
- Directed to specific makers or broadcast to all
- Disclosed (non-anonymous) or anonymous
Roles
- Taker: The party that creates the RFQ and can accept quotes
- Maker: The party that provides quotes on RFQs
Authentication
All private endpoints and WebSocket channels require authentication using API keys. See the Authentication documentation for details.
Getting Started
- Review the REST API documentation
- Review the WebSocket API documentation
- Set up authentication credentials
- Start with querying instruments and makers
- Create your first RFQ