decibel_skill

Overview

This skill provides expert guidance and actionable examples for integrating with Decibel, an on-chain perpetual futures trading platform on Aptos. It covers the trading engine, on-chain orderbook, TypeScript SDK, REST APIs, WebSocket streams, TWAP orders, market data, position and vault operations. The content is focused on practical code snippets, endpoint usage, and production-ready patterns for trading and automation. Use it to build trading bots, dashboards, or account management tooling that interact with Decibel securely and efficiently.

How this skill works

The skill explains how to query market data via REST, stream real-time updates via WebSocket, and place or manage orders using the TypeScript SDK. It maps common trading tasks (place/cancel orders, manage positions, create TWAPs, subaccounts, vault ops) to concrete API calls and SDK methods. It also outlines authenticated channels for account, orders, positions, and fills so you can maintain state in real time. Error codes and retry patterns are included to make integrations resilient.

When to use it

• Building algorithmic trading bots for on-chain perps on Aptos.
• Integrating market data (prices, orderbook, trades, candles) into analytics or UIs.
• Implementing TWAP execution to reduce market impact for large orders.
• Managing multiple traders via subaccounts, delegations, or vault strategies.
• Streaming live fills, position updates, and order lifecycle events for risk monitoring.

Best practices

• Use WebSocket subscriptions for real-time orderbook, trades, and account updates instead of polling REST.
• Implement robust error handling for codes like INSUFFICIENT_MARGIN, INVALID_PRICE, and RATE_LIMITED with backoff and retries.
• Use TWAP orders for large executions and set TP/SL to protect against runaway losses.
• Monitor margin and funding rate history and enforce automated liquidations or alerts.
• Isolate strategies into subaccounts and use delegations with limited permissions for third-party bots.

Example use cases

• A market-making bot subscribing to orderbook and trades for BTC-PERP and placing limit orders via the SDK.
• A dashboard fetching candles and price feeds to display portfolio P&L and open positions in real time.
• An execution service that breaks a large order into TWAP slices and monitors fills via the fills channel.
• A risk manager that watches positions and automatically sets stop-loss/take-profit using position management endpoints.
• A multi-strategy vault that deposits funds, runs strategies per subaccount, and periodically withdraws profits.