🚀 New Public API: Staking Endpoints Are Live!

Swagger (interactive docs): https://api.ston.fi/swagger-ui/#/

New endpoints:
• GET /v1/wallets/{address}/stakes/
• GET /v1/stats/staking

Use these to fetch a wallet’s staking positions and global staking stats via REST—now supported in the JS SDK.

SDK:
• @ston-fi/api → https://www.npmjs.com/package/@ston-fi/api
• Changelog → https://github.com/ston-fi/api/blob/main/CHANGELOG.md#0250


DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

you asked, we deliver…

Attention Devs! 🚀

We’re excited to roll out a brand‑new addition to our developer docs:

Omniston Python Guide 🐍✨

This beginner‑friendly, step‑by‑step tutorial shows you how to build a terminal-based token swap client that routes across multiple DEXes via the Omniston protocol (STON.fi V1 & V2, DeDust, and more). Instead of a web UI and TonConnect, you’ll use a local TON wallet (via tonsdk) and submit transactions through Toncenter—all from a single Python file.

Highlights include
• Terminal-first, single-file CLI for maximum clarity (easy to copy, run, and tweak).
• Local wallet flow with tonsdk: generate/load mnemonic, deploy, sign BOCs.
• Real-time quotes over WebSockets using Omniston (RFQ), with slippage & gasless options.
• Transaction building via Omniston’s builder and broadcast with Toncenter.
• Simple config using .env and swap_config.json (endpoints, pair, amount, decimals).
• Cross‑DEX coverage through Omniston (STON.fi V1, STON.fi V2, DeDust, etc.).

⚠️ Not an official Python SDK
This guide is a high‑level reference implementation that demonstrates how to leverage Python to use Omniston. It’s optimized for learning and clarity, not production hardening. For production apps, consider our React, Node sdks or adapt this code with your own engineering standards.

🔑 Heads‑up on broadcasting
For reliable transaction submission, set TONCENTER_API_KEY in your .env. Without it, you will not be able to submit transactions to the network.

🧩 Deliberately minimal
The quickstart uses a single‑file CLI by design. You can modularize or package it later.

What you’ll build
• A Python CLI that:
• Creates or reuses a local TON wallet (tonsdk).
• Loads network/token settings from .env and swap_config.json.
• Requests an RFQ from Omniston via WebSockets.
• Builds the swap transaction and signs it locally.
• Submits the signed BOC to Toncenter.

Jump in:
👉 Omniston Python Guide
👉 Live Demo (Replit)

Your insights and feedback help us sharpen the Python experience and the Omniston protocol. Try the guide, kick the tires, and tell us what you think—let’s build together! 🔥

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 STON.fi API Update — Redoc, 3 New Endpoints & Smarter Queries

📘 Redoc is live. Explore a fresh, clean, deep‑linkable view of the public API.
➡️ https://api.ston.fi/redoc

🆕 New endpoints
• transaction.action_tree — returns a flattened tree of all STON.fi actions and statuses triggered by an initial tx.
• transaction.query — look up a transaction by (wallet + query_id) or by external message hash.
• wallet.transactions.last — fetch the latest transactions for a wallet.

🔧 Upgrades to existing endpoints
• pool.query — route is now /v1/pools/query (old /v1/pool/query remains for backward compatibility). Adds:
• search_term — search by asset name/ticker/address or pool address
• sort_by — order by tvl, popularity, relevance, or pool/asset tags
• limit — return the top‑N pools
• asset.query — now supports search_term, sort_by, and limit for faster, cleaner discovery (e.g., search by name/ticker/address; sort by popularity/relevance/tags; cap to top‑N).

⚠️ Deprecation note asset.search is now soft‑deprecated — please use asset.query (/v1/assets/query) going forward.

Dive in 👉 https://api.ston.fi/redoc

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Omniston Update — Flexible Referrer Fee (opt‑in) for Better Quotes

We’ve added a new flag to help you capture sharper prices without manual tuning.

🆕 What’s new
• flexible_referrer_fee (API) / flexibleReferrerFee (SDK)
Let resolvers lower the effective referrer fee below referrerFeeBps when it improves the swap rate.
Default: false (fully backward‑compatible).

🛠️ Where it’s available
• JS/TS SDK: @ston-fi/omniston-sdk v0.7.5
• React SDK: @ston-fi/omniston-sdk-react v0.7.7

📚 Docs & examples updated
• RFQ/settlement params, request bodies and code samples now include the flag.

✏️ Quick usage

// SDK
settlementParams: {
  flexibleReferrerFee: true
}

Why it matters: more competitive quotes, higher fill rates—while keeping your referrer fee intact unless a better rate is available.

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🔔 Important Update — Fee-Vault Minter

We’ve deployed a new Fee-Vault Minter at EQD5TIvGT6NxphRDKX9wRUkJOHyE0VTuTGdVSGA5N_b62naH.
All new fees will be directed to this contract.

🧾 Users can claim accrued fees from the previous contracts
EQBCAUfvMMSn-WHP0bKDs4wUVOK1r55OuHJIq25_QnVFCFye and EQAAoyu0C-aMYGPVEoMfuAge2-meJWeO5KLJKrKWJAJAKXGL, as well as from the new one.

Please check updated 📚 docs


DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🎥 New Video Tutorial: AI Agenting Omniston Implementation

We’ve published a step-by-step walkthrough showing how to use an AI coding agent (Gemini CLI example) to implement the Omniston React quickstart end-to-end.

▶️ Watch: here
📘 Docs: here

What’s inside:
🧰 Project scaffold → deps install → Tailwind + Vite setup
🔌 TonConnect wiring (connect button & manifest)
🔁 RFQ flow: request quote → build/send tx → track trade
🧠 Agent workflow with Gemini CLI (works similarly with Claude, Copilot, Cursor)
⚡ Tips & best practices to move from zero → swap in minutes

Try it, remix it, and tell us what you want next! 🚀

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🔔 Important Update — Fee-Vault Minter

We’ve deployed a new Fee-Vault Minter at EQCcJf2KFlH9xIx3dztytxxRFk3KQZKEYBr-f0nFIO1h3dvv.
All new fees will be directed to this contract.

🧾 Users can claim accrued fees from the previous contracts
EQBCAUfvMMSn-WHP0bKDs4wUVOK1r55OuHJIq25_QnVFCFye and EQAAoyu0C-aMYGPVEoMfuAge2-meJWeO5KLJKrKWJAJAKXGL, EQD5TIvGT6NxphRDKX9wRUkJOHyE0VTuTGdVSGA5N_b62naH, as well as from the new one.

Please check updated 📚 docs

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Omniston Widget — Plug-and-Play Swaps + Referral Fees

Drop a full Omniston-powered swap UI into any site or dApp using the @ston-fi/omniston-widget-loader npm loader or a lightweight CDN bundle. Your users get best-rate swaps, you get fees — no low-level DeFi wiring.

💼 Why it matters:

• 💸 Monetize traffic – earn 0.01%–1% referral fees on every swap.
• 🧩 Zero DEX UI to maintain – Omniston handles routing & execution.
• 🎨 On-brand – theme via CSS variables so it looks native to your app.

🧪 How to integrate:

• 📘 Docs: Start with the Omniston Widget overview and the Full Guide & Reference for CDN, npm loader, TON Connect modes, and theming.
• 🧱 Examples: Clone and remix the open-source omniston-widget-loader repo with ready-made integrations.
• 🤖 AI build (no manual coding): Use “Try it with Lovable” in the docs to auto-generate a live page with the widget already wired in.

Drop the widget in, point it at your TON Connect manifest, set your referrer, and you’ve just added a revenue-generating swap surface to your app with almost zero engineering overhead.

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🎥 New Video Tutorial — “Try it with Lovable” (Omniston Widget)

Want a working swap page without being a dev? This walkthrough shows how to go from one prompt → published page → live swaps, then where to find info about referral fees to start earning.

▶️ Watch
📘 Docs (Try it with Lovable)

What you’ll see inside:
• 🤖 Prompt → instant widget page generation
• 🔌 Live test of implementation
• ⏭️ Where you can go next?

🧱 Widget implementation examples repo
📚 Widget full docs

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🧩 New: STON.fi Widget Configurator — Build Your Swap UI in Minutes

We’ve launched a new Widget Configurator that lets you visually build, customize, and deploy an Omniston-powered swap widget — no guesswork, no trial-and-error. Configure once, embed anywhere.

Why it matters:

🛠 Visual configuration – set tokens, theme, referrer, and behavior without digging through docs.

⚡️ Faster integration – generate ready-to-use embed code instantly.

🎨 On-brand by default – fine-tune colors, layout, and UI to match your app.

💸 Built-in monetization – referral fees still work out of the box.

How to use it:

📘 Docs: Start with the Widget overview and Configurator section
https://docs.ston.fi/developer-section/widget

🧱 Generate code: Use the configurator to produce a widget snippet for CDN or npm loader setups.

🔌 Plug & play: Drop the code into your site or dApp and configure TON Connect.

The configurator removes friction from integration — so you can focus on shipping features, not wiring swap UIs.

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube