Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

REST API

STON.fi DEX API documentation - RESTful interface for programmatic DEX access and data queries

The STON.fi DEX REST API provides asset and pool metadata, swap and liquidity simulations, wallet data, transaction queries, and statistics.

API endpoint: api.ston.fi

Limits

Currently, there are no limits for DEX API use.

API Viewers

You can explore the full schema and try requests via:

SDK

Use the TypeScript SDK to access the API from JavaScript and TypeScript.

API Reference

For a complete list of all available endpoints with brief descriptions, please refer to our API Reference.

Referral Fee Endpoints

The following endpoints expose integrator-fee data for STON.fi DEX v2 Vaults:

  • Wallet-level vaults: GET /v1/wallets/{address}/fee_vaults Lists referral fee vaults for STON.fi DEX v2 for a given referrer.

  • Fee statistics:

    • GET /v1/stats/fee_accruals: Referral fee accrual history for DEX v2 fee Vaults; DEX v1 direct payouts are not this Vault dataset

    • GET /v1/stats/fee_withdrawals: Withdrawals from DEX v2 vaults

    • GET /v1/stats/fees: Aggregated referral fee stats

These endpoints cover STON.fi DEX v2 fee Vaults. For fees accrued through other TON liquidity protocols, use the TON payout contract reference.

For a full description of how referral fees are calculated and settled across DEX v1, DEX v2, DeDust, and TONCO, see the Integrator fees in Omniston guide.

Last updated