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
  • The Swap Process
  • Key Considerations
  1. CONCEPTS

Firm Quote Orders

PreviousOrderbookNextAuto Sign Orders

Last updated 4 months ago

One approach to execute a swap via Native is by using the /firm-quote endpoint, which provides a firm quote along with signed calldata for on-chain execution.

For further details, refer to the following link:

The Swap Process

  1. Swappers query the /orderbook endpoint to obtain pricing and depth information and generate an initial quote.

  2. Swappers submit the swap parameters, including the amount and token addresses, via the /firm-quote endpoint to receive a firm quote and executable calldata.

  3. The calldata is executed on the blockchain to finalize the swap.

Key Considerations

  • Utilize the /orderbook or /indicative-quote endpoints for initial pricing estimates, typically displayed on the primary swap interface. The /firm-quote endpoint should be used for finalizing quotes before on-chain transactions.

  • The /firm-quote endpoint may experience rate limits and slightly higher latency due to inventory control, additional checks, and signing processes.

  • Specify the "expiry" parameter when requesting a firm quote. Note that longer expiries may reduce PMM liquidity, potentially resulting in less favorable quotes.

  • Native aggregates liquidity from on-chain AMM DEX sources. Consequently, final signed orders may include swaps involving external liquidity. However, Swap API keys can be configured to exclusively utilize PMM quotes.

GET Firm quote