Kana Labs
  • Getting Started
    • Welcome to Kana Labs
  • CROSS CHAIN SWAPS
    • AMM DEX Aggregator
  • INTEGRATE KANA WIDGET
    • Kana Widget
      • Install Widget
      • Configure Widget
      • Configure Aptos Keyless
  • Web3 Aggregator SDK
    • Web3 Aggregator SDK
      • Installation
      • SameChain
      • Cross Chain Swap
      • Aggregator API's
  • SPOT TRADING PLATFORM
    • Kana Trade
      • API Docs
  • PERPETUAL FUTURES
    • Kana Perps
      • Getting Started
        • Mint Tokens on Testnet
      • Breaking Down Kana Perps
        • Assets Supported
        • Order Types
        • Orderbook
        • Funding Rate
        • Leverage
        • Margin and Liquidation
        • Hedge Mode
          • Hedging a Short-Term 2-3% Price Decline
          • Dual Positioning for Flexible Profit-Taking
        • Trading Fees
      • API Docs
        • Installation Setup
        • Kana Perps Typescript REST API
        • Kana Perps Python Websocket API
        • Kana Perps Python REST API
        • Steps to place an order
        • Perps Contract Error Codes
        • Websocket Connection
        • Supported Markets
  • SPOT & PERP APIs
    • Trading APIs
      • Kana Trade API
      • Kana Perps API
        • Installation Setup
        • Example setup functions
        • Kana Perps Typescript REST API
        • Kana Perps Websocket API
        • Kana Perps Python Websocket API
        • Kana Perps Python REST API
        • Steps to place an order
  • PAYMASTER SERVICE
    • Kana Paymaster For Aptos and Supra
      • How it works?
      • How to Register?
      • Deposit Allowance
      • Manage Users
      • Paymaster SDK Tutorial (Typescript)
      • Paymaster API
      • Module & Function Whitelist
      • Subscription - Coming soon
      • FAQS
  • PERPETUAL OPTIONS
    • OPerps
  • Tokenomics & Governance
    • Kana Labs Tokenomics
  • REWARDS & REFERRAL PROGRAM
    • Rewards Program
      • Reward Program Season 1
      • Reward Program Season 2
      • How to Keep Track of Your Points?
      • Where to find the Missions Dashboard?
  • Referral Program
    • How to Generate Referral Link? (For the Referrer)
    • How to map your wallet to the invite IDs? (For the invited users)
Powered by GitBook
On this page
  • Important Note:
  • How to Fetch the Profile Address:
  • How to subscribe websocketURL:
  1. PERPETUAL FUTURES
  2. Kana Perps
  3. API Docs

Websocket Connection

PreviousPerps Contract Error CodesNextSupported Markets

Last updated 3 days ago

Important Note:

For all the Websocket endpoints below, pass your profile address.

To track your transactions on-chain (e.g., via Aptos Explorer or Aptos Scan), you must use your profile address, as all on-chain trades are executed using this profile address.

To obtain your profile address, use the /getProfileAddress endpoint and provide your wallet address as the userAddress parameter.

How to Fetch the Profile Address:

Example endpoint: Example code: get-profile-address

How to subscribe websocketURL:

✅ Testnet WebSocket URL

wss://perpetuals-indexer-ws-develop.kanalabs.io/ws/

✅ Mainnet WebSocket URL

wss://perpetuals-indexer-ws.kana.trade/ws/

Connect websocket with URL

  • order_history

{
  "topic": "order_history",
  "address": "{{user_address}}"
}
  • deposit_withdraw_history

{
  "topic": "deposit_withdraw_history",
  "address": "{{user_address}}"
}
  • trade_history

{
  "topic": "trade_history",
  "address": "{{user_address}}"
}
  • positions

{
  "topic": "positions",
  "address": "{{user_address}}"
}
  • open_orders

{
  "topic": "open_orders",
  "address": "{{user_address}}"
}
  • orderbook

{
  "topic": "orderbook",
  "market_id": "{{market_id}}"
}
  • recent_trades

{
  "topic": "recent_trades",
  "market_id": "{{market_id}}"
}
  • live_funding_rate

{
    "topic": "live_funding_rate"
}

send message like and subscribe to websocket

https://perps-tradeapi.kanalabs.io/getProfileAddress?userAddress=0xd01e3a233632a41463bd6d289e99e69e1b50815c7afff710e1c992659a8722f3
https://docs.kanalabs.io/perpetual-futures/kana-perps/api-docs/kana-perps-typescript-rest-api#id-20.-