# Bulk labs Docs

- [Introduction](https://docs.bulk.trade/index.md)
- [Design Philosophy](https://docs.bulk.trade/design-panorama.md): The architectural principles and design goals behind BULK Exchange.
- [Architecture Overview](https://docs.bulk.trade/architecture/overview.md): BULK - a specialized execution layer running natively alongside Solana.
- [BULKBFT Consensus](https://docs.bulk.trade/architecture/consensus.md): Leaderless Byzantine fault-tolerant consensus for the BULK Network.
- [Fair Ordering](https://docs.bulk.trade/architecture/fair-ordering.md): How BULK prevents transaction reordering, censorship, and MEV extraction through multi-layered fairness.
- [Taker Speed Bump](https://docs.bulk.trade/architecture/taker-speed-bump.md): How BULK gives maker liquidity a 25 ms window before taker-capable transactions become eligible for execution.
- [Order Book](https://docs.bulk.trade/bulk-exchange/Orderbook.md): Central limit order book architecture on BULK Exchange.
- [Matching and Execution](https://docs.bulk.trade/architecture/matching.md): How the BULK executor processes committed batches through the matching engine.
- [Real-Time Risk Engine](https://docs.bulk.trade/architecture/risk-engine.md): Regime detection, lambda surfaces, portfolio margin, and cascade adjustment in BULK's real-time risk engine.
- [Deterministic Clock](https://docs.bulk.trade/architecture/timestamps.md): Anti-entropy maintenance on the BULK Network.
- [Protocol Native Asset Transfer](https://docs.bulk.trade/architecture/transfers.md): Internal and external token transfers between accounts and sub-accounts - all executed natively inside the BULK protocol.
- [Security Practices](https://docs.bulk.trade/architecture/security.md): How BULK secures user funds, network consensus, and on-chain settlement.
- [Audits](https://docs.bulk.trade/architecture/audits.md)
- [Margin](https://docs.bulk.trade/bulk-exchange/Margin.md): Portfolio margin, correlation-adjusted risk, and dynamic lambda surfaces on BULK Exchange.
- [Portfolio Margining](https://docs.bulk.trade/bulk-exchange/portfolio-margining.md): True portfolio margining on-chain - capital efficiency, multi-asset collateral, and the future of risk management.
- [Sub-Accounts](https://docs.bulk.trade/bulk-exchange/sub-accounts.md): Partition a single master account into independent sub-accounts, each with its own margin, positions, and risk profile.
- [Isolated Margin](https://docs.bulk.trade/bulk-exchange/isolated-margin.md): Isolate risk per instrument with auto-created isolated accounts, or manually via sub-accounts.
- [Order Types](https://docs.bulk.trade/bulk-exchange/Order-Types.md): Order types, time-in-force options, and execution modifiers on BULK Exchange.
- [Price Indices](https://docs.bulk.trade/bulk-exchange/Price-Indices.md): Oracle price, mark price computation, and PnL calculation on BULK Exchange.
- [Funding](https://docs.bulk.trade/bulk-exchange/funding.md): Hourly funding rate mechanism on BULK Exchange.
- [Conditional Orders (TP/SL)](https://docs.bulk.trade/bulk-exchange/conditional-orders.md): Stop, Take-Profit, Range, Trigger, Trailing, and On-Fill orders on BULK Exchange.
- [Liquidations](https://docs.bulk.trade/bulk-exchange/Liquidations.md): How BULK prices closeout risk and selectively restores account margin.
- [Auto-Deleveraging](https://docs.bulk.trade/bulk-exchange/ADL.md): Last-resort shortfall and underfill handling on BULK.
- [Fees](https://docs.bulk.trade/bulk-exchange/fees.md): Fee tiers, maker rebates, and the BULK Alpha Program.
- [Builder Codes](https://docs.bulk.trade/bulk-exchange/builder-codes.md): Builder Codes on BULK Exchange.
- [High Frequency Market Making](https://docs.bulk.trade/bulk-exchange/hf-market-making.md): Open market making on BULK with deterministic ordering and a uniform maker window.
- [Self-Trade Prevention](https://docs.bulk.trade/bulk-exchange/Self-Trade-Prevention.md): How BULK prevents users from matching orders against themselves.
- [Contract Specifications](https://docs.bulk.trade/bulk-exchange/Contract-Specifications.md): Perpetual contract parameters on BULK Exchange.
- [Challenger Series](https://docs.bulk.trade/bulk-exchange/points.md): A seasonal ranked league for BULK traders.
- [Referral](https://docs.bulk.trade/bulk-exchange/referral.md): BULK Referral program.
- [BIP-1: Deployer-Owned Perpetual Contracts](https://docs.bulk.trade/bips/bip-1.md): Deploy various markets on BULK.
- [Getting Started](https://docs.bulk.trade/validators/getting-started.md): How to run a BULK Network validator.
- [Rewards](https://docs.bulk.trade/validators/rewards.md): How validators earn a share of exchange fees on the BULK Network.
- [Paper Trading Competition](https://docs.bulk.trade/misc/paper-trading-comp.md): The first ever BULK Trading Competition. $50,000 paper-trading prize pool, ranked by Skill Score.
- [Portfolio Margin Calculator](https://docs.bulk.trade/misc/margin-calculator.md): Interactive portfolio margin calculator with real risk surfaces across all regimes.
- [API Overview](https://docs.bulk.trade/api-reference/introduction.md): HTTP & WebSocket API
- [Public API Rate Limits](https://docs.bulk.trade/api-reference/rate-limits.md): Mainnet public HTTP and WebSocket limits, burst budgets, and retry behavior.
- [Transaction Signing](https://docs.bulk.trade/api-reference/signing.md): All state-mutating operations require network-bound Ed25519 signatures over the canonical wincode binary message
- [Order IDs](https://docs.bulk.trade/api-reference/orderIds.md): Deterministic order IDs - no client order ID required; compute on the fly or use bulk-keychain
- [API Changelog](https://docs.bulk.trade/api-reference/changelog.md): API updates and version history
- [Get Exchange Info](https://docs.bulk.trade/api-reference/getExchangeInfo.md): Returns information about all available markets.
- [Get Market Ticker](https://docs.bulk.trade/api-reference/getTicker.md): Returns 24-hour statistics for a specific symbol.
- [Get Candles (OHLCV)](https://docs.bulk.trade/api-reference/getKlines.md): Returns historical candlestick data for charting.
- [Get L2 Order Book](https://docs.bulk.trade/api-reference/getL2Book.md): Returns current order book snapshot with optional filtering.
- [Get Exchange Statistics](https://docs.bulk.trade/api-reference/getStats.md): Returns exchange statistics with optional symbol filtering.
- [Get Risk Surfaces](https://docs.bulk.trade/api-reference/getRiskSurfaces.md): Returns the complete risk configuration surface set for one market across all regimes. This is a read-only snapshot endpoint and does not mutate state.
- [Get Size-Impact Curve](https://docs.bulk.trade/api-reference/getImpact.md): Returns the latest executor-published liquidation-size impact curve cached for one market. Returns `404` until the first curve has been published for the requested symbol.
- [Get Fee State](https://docs.bulk.trade/api-reference/getFeeState.md): Returns active fee policy/schedule state for protocol/global scopes. This endpoint is read-only and unsigned.
- [Query Account (Unsigned)](https://docs.bulk.trade/api-reference/getAccount.md): Query account information. **No signature required** - read-only operation.
- [Place & Cancel Orders (Signed)](https://docs.bulk.trade/api-reference/placeOrder.md): Place limit/market orders, cancel, and modify via the unified transaction endpoint
- [Manage Agent Wallet (Signed)](https://docs.bulk.trade/api-reference/manageAgentWallet.md): Register or remove an agent wallet via the unified transaction endpoint
- [Update User Settings (Signed)](https://docs.bulk.trade/api-reference/updateUserSettings.md): Set per-symbol max leverage via the unified transaction endpoint
- [Sub-Accounts (Signed)](https://docs.bulk.trade/api-reference/manageSubAccounts.md): Create, rename, and remove sub-accounts via the unified transaction endpoint
- [Transfer (Signed)](https://docs.bulk.trade/api-reference/transfer.md): Move margin between accounts (internal, external, isolated-account top-up) via the unified transaction endpoint
- [Request Testnet Faucet (Signed)](https://docs.bulk.trade/api-reference/requestFaucet.md): Request testnet funds via the unified transaction endpoint
- [WebSocket Overview](https://docs.bulk.trade/api-reference/websocket-intro.md): Real-time market data and trading via WebSocket
- [Market Data Streams](https://docs.bulk.trade/api-reference/ws-market-data.md): Real-time price feeds, candles, trades, and order books
- [Account Stream](https://docs.bulk.trade/api-reference/ws-account.md): Real-time account updates including positions, orders, margin, and comprehensive risk metrics. No signature required for subscribing (public data)
- [Trading via WebSocket](https://docs.bulk.trade/api-reference/ws-trading.md): Submit orders and other actions through WebSocket using the unified transaction format
- [Connection Management](https://docs.bulk.trade/api-reference/ws-connection.md): Subscriptions, reconnection, and best practices

## OpenAPI Specs

- [openapi-agent-wallet](/api-reference/openapi-agent-wallet.yaml)
- [openapi-faucet](/api-reference/openapi-faucet.yaml)
- [openapi-sub-accounts](/api-reference/openapi-sub-accounts.yaml)
- [openapi-transfer](/api-reference/openapi-transfer.yaml)
- [openapi-update-settings](/api-reference/openapi-update-settings.yaml)
- [openapi](/api-reference/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.