Native Documentation
  • introduction
    • What is Native
    • About Native V2
    • Benefits for Key Players
  • SOLUTION
    • Native Credit Pool
    • Native Swap Engine
  • CONCEPTS
    • Orderbook
    • Firm Quote Orders
    • Auto Sign Orders
    • Swap Fees
    • Slippage
    • Base and Listed Assets
    • Single-Sided Liquidity Pools
    • Total Available Liquidity
    • Liquidity Pairing
    • Liquidity Bootstrapping
    • Health Ratio
    • Earning Fees and Incentives
    • Credit-Based Swap
      • Collateral Factor
      • PMM Credit
      • Settlement and Liquidation
    • Market-Responsive Pricing
    • Risks
  • USER GUIDE
    • Add Liquidity
    • Pair Liquidity
    • Claim Rewards
    • Swap with Native
  • Build with Native
    • Swap Aggregators
      • Guide
      • FirmQuote Swap APIs
        • GET Orderbook
        • GET Indicative quote
        • GET Firm quote
    • Asset Issuers
      • For Pegged Assets
      • For General Assets
  • Resources
    • Addresses
    • Audits
    • Github
    • System Status
    • Business Source License
    • Media Kit
Powered by GitBook
On this page
  • Server URL & authentication
  • WebSocket message types
  1. Build with Native
  2. Private Market Makers[june]
  3. Guide

WebSocket Integration

Last updated 7 months ago

WebSocket integration serves as an alternative to HTTPS integration. While the overall flow remains the same, WebSocket allows you to stream order book data to Native instead of having Native pull the data from your server.

Server URL & authentication

Native's WebSocket URL is hosted at: https://newapi.native.org/v1/pmm/ws .

To authenticate all incoming requests, you need to include the api_key in the headers. You can obtain an api_key by requesting it from the Native team, as the API key needs to be manually whitelisted for access to the WebSocket URL.

Note: You are required to connect to our WebSocket via the ws library, not the socket.IO library. For further examples, you can visit the Market Maker WebSocket Client demo on our .

WebSocket message types

To fully integrate with Native and utilize its full capabilities, you must implement and handle the following message types:

  • : Enables Native to estimate prices for different order sizes.

  • : Allows Native to obtain a price from you for the requested token and amount.

  • : Enables you to validate and sign the order for on-chain execution.

GitHub
Orderbook
Firm-Quote
Sign-Quote