API Reference
These docs are for v2.0. Click to read the latest docs for v2.0.1.

Introduction

This reference is your key to a comprehensive understanding of the Bluefin Protocol Smart Contracts and API.

Bluefin is a decentralized, order book-based exchange that offers advanced trading strategies, liquid markets, and high-performance APIs. Our goal is to accelerate the onboarding of institutional, professional, and first-time traders to decentralized markets and return value to our community.

Bluefin is powered by a unified Central Limit Order Book (CLOB) and on-chain smart contracts, providing the speed and performance of a centralized exchange with the security, decentralization, and self-custody of DeFi.
The Off-Chain Central Limit Order Book provides traders with extremely low latency and no-cost order posting, enhancing the speed and experience of Bluefin to match that of a CEX.

Bluefin is accelerating the adoption of decentralized markets by matching the performance and experience of a Centralized exchange, with decentralized infrastructure and self-custody.

Order Books provide several advantages over AMMs, allowing professional and Institutional traders to employ their existing infrastructure and trading strategies on the Exchange, accelerating the onboarding of institutional liquidity and flow. Institutional, HFTs, and automated traders can access the highly performant Bluefin exchange through the Bluefin API and SDKs.

Bluefin is non-custodial, giving traders the confidence that they always retain full control of their assets.

Bluefin’s decentralized infrastructure ensures that all assets are held on-chain, and nobody can access or modify customer assets beyond contract actions like liquidations. Additionally, there is no centralized control of trades once matched, as no signature is stored even during a session, and every action must be signed by the user. Lastly, the protocol ensures that no centralized censorship is possible, as all trades sent directly on-chain, bypassing off-chain operators, cannot be edited.

Learn more in depth about Bluefin Exchange here.

API Integrations

Integrations with the Bluefin Protocol enable access to programmatically place & cancel orders on the off-chain Orderbook via REST endpoints, retrieve public market information via REST endpoints, retrieve user history via REST endpoints and make direct on-chain contract interactions via RPC calls. Using the navigation menu on the left, you'll find details on each area of functionality exposed by the protocol.

Code Samples & Client Libraries

Examples of requests and responses are provided for each endpoint, demonstrated using the Bluefin TypeScript Client, Python Client and cURL. These examples simplify the process of copying, pasting, and adjusting as you develop your integration.

Bluefin clients are open-source projects that facilitate a smooth start to building. You may also opt for any other language or library that supports making HTTP requests.