Our first DEV announcement is out there 🔥

☕️ Our technical documentation has just been extended with staking protocol insights.

ℹ️ Whilst it may lack some of information, it already provides a brief overview of overall protocol architecture, some TL-B schemes and func-code examples for those wanting to understand how it works from the inside or who is trying to integrate/interact with staking contracts by themselves.

Thank you for your interest in swap.coffee 🥰

And stay tuned for more technical updates 🐸

⚡️Attention! API changes!⚡️

🏆In anticipation of the release of staking-for-partners platform, our Rest API has been updated.

ℹ️If you have interacted with our Rest API methods related to staking, you need to migrate from v1 to v2. In all places where new argument master_address is being used, you must pass EQCMtrnKhK82Yw6xHrLm_rJLkMYxeYIilhdmn6BnVGZ1PnBM (address of CES staking master contract).

For backwards compatibility purposes, some of the v1 methods will remain available for the next week, but they're already marked as deprecated.

Moreover than that, there are some property renamings even within v1 methods:

GET /v1/staking
- root.total_locked_ces_native renamed to root.total_locked_native

GET v1/staking/{address}
- root.positions[i].locked_ces_native renamed to root.positions[i].locked_native
- root.positions[i].locked_ces_usd renamed to root.positions[i].locked_usd

👉 If you have issues with your services migration related to this change, consider contacting us in our dev chat. ☀️

⚡️Attention! API Changes!⚡️

Those who independently followed the updates of our Rest API before the creation of this channel may have noticed that about a month ago a v2 method for obtaining the results of the execution of swap transactions appeared in it.

✨Although the v1 method was deprecated, it was still supported throughout this whole time, but today we would like to announce the date of its abandonment.

ℹ️If you still use /v1/route/results, please consider migrating to /v2/route/results. The difference between methods is as follows:

1. v1 method provided amount of coins as absolute values (for example, 1 TON was denoted as 1), whilst v2 method provides them as raw values (1 TON is denoted as 1000000000). However, new method also provides information about token decimals, therefore you're able to convert raw amounts to absolute ones by your own hands if it's needed.
2. v2 method also provides information about gas (or, more precisely, TON amount for gas payments) that was sent at the transaction beginning, and gas that was received back when transaction completed (either successfully or by slippage tolerance/deadline/etc).

💥Old method will be removed from the Rest API at the end of next week (13th of December'24).

👉 As always, if you have issues with your services migration related to this change, consider contacting us in our dev chat. 🥰

Introducing Our New Documentation! 🪅
Welcome to the World of swap.coffee 🌎

We're excited to unveil our comprehensive platform guide—now with all essential information in one convenient place! Whether you're new to DeFi or an experienced trader, our documentation will guide you through every feature and function. 🎯

📕 Learn. Trade. Grow.

Access the full documentation at https://docs.swap.coffee/

With attention to detail,
swap.coffee Team ☕️

💻 Strategy Orders

About a week ago, LIMIT and DCA orders became available on swap.coffee.

Now we are ready to please technical specialists and integrators interested in using these products by providing API, SDK and documentation for it. 💡

- Rest API
- SDK
- Documentation

Remember that you can always ask any questions about new or existing functionality in our development chat, and our team will be happy to help you. ☀️

UI Widget Kit Update 👩‍💻

We’ve just updated the UI Widget Kit — it now includes several important improvements.

• New design
• MEV Protect support
• Limit Orders and DCA support
• Token list management
• Liquidity provider management
• Initial tokens (firstToken, sendToken)
• Default amount value configuration
• Option to hide Limit/DCA

The updated documentation is already available.

swap.coffee at the TON Mini Apps Build Contest AMA Session

As part of the TON Mini Apps Build Contest, we’ll be sharing how to connect a Mini App with backend services, smart contracts, and blockchain-based notifications in Telegram.

Our lead developer Nikita Duginets will cover:
• Backend architecture and logic for Mini Apps
• Session handling and user verification with TON Proof
• Smart contract integration and transaction tracking

Got questions?
Use the hashtag #AskSwapCoffee so we can answer them live or pass them on to the team.

Join us tomorrow (April 30) at 18:00 (UTC+3): Telegram, X (Twitter), YouTube, Twitch

With love, swap.coffee ❤️

✉ App 🌐 Guide 🤖 Discord 📹 YouTube 🐣 X

Meet Coffee DEX 🧩

It is the foundation of a new generation of swap exchanges.Coffee is a powerful, extensible and open protocol designed for both users and developers.

👑 Coffee DEX provides the smoothest possible user experience: smart routing, lowest gas consumption compared to other solutions on the DEX market, support for using liquidity from other protocols. It's a solution where security, efficiency and flexibility work together.

👨‍💻 In the coming weeks, Coffee DEX will become a hub for developers to realize any idea. We are proud to open the source code of our advanced DEX, so even beginners can develop their own AMM or start their own DEX with just a couple of features.
Link to GitHub. ✍️

🔒 The security of our DEX is confirmed by Trail Of Bits, one of the most reputable audit companies in the world. You can read the results of the audit here.

⚡️ Combined with our product and deep partner integrations, Coffee DEX already sets the standard in terms of efficiency and architecture, but this is just the beginning. We're actively working to expand functionality and will be adding key features in the coming months that make DeFi truly powerful. Stay tuned for more updates! 🛫

ℹ️ You can already move your liquidity in just a few clicks and benefit from boosted APRs.

With love, swap.coffee ❤️

✉ App 🌐 Guide 🤖 Discord 📹 YouTube 🐣 X

Hello Everyone 👨‍💻

Today, we are excited to announce the launch of Thermos, the best gift aggregator on Telegram!

No fees, no hidden charges 🏆

We are open to developers and new projects provide an API for anyone!

You can find the API documentation here: https://docs.swap.coffee/technical-guides/thermos/backend-api.

Feel free to create your own products with Thermos.

Introducing Smart Mode 🧠

💪 No more manual settings — forget about adjusting slippage, managing intermediate tokens, or analyzing pool volatility.

💻 Smart Mode handles everything for you.
We’ve built an intelligent AI-powered algorithm into the new mode that automatically finds the best conditions for your swap.

🤖 How Smart Mode works:
— Selects the most optimal swap route;
— Automatically sets slippage for maximum safety;
— Calculates ideal trade parameters in real time while minimizing intermediary tokens;
— Activates MEV Protect when needed.

Now live on swap.coffee 🪩

✉ App 🌐 Guide 🤖 Discord 📹 YouTube 🐣 X

⚡️⚡️⚡️
Due to the @thermos infrastructure update, the proxy.thermos.gifts will be unavailable for up to 10 minutes.

There may also be interruptions in availability today from 9 PM to 1 AM UTC.

Update: proxy is available again :)

⚡️⚡️⚡️
Due to the scheduled @thermos maintenance, website & backend.thermos.gifts will be unavailable from 21:30 UTC to 23:00 UTC. After the maintenance, certain schemas in backend.thermos.gifts will be updated (specifically, the types of all price fields will be changed from integer to string).

proxy.thermos.gifts will remain available.

swap.coffee Grant Program 🔥

🫢 We’re opening the swap.coffee Grant Program — an initiative to support developers, teams, and projects building solutions on top of our infrastructure within the TON ecosystem.

🤑 The program provides financial, technical and promotional support to those who bring value to the platform, improve user experience and expand technical capabilities. The size of each grant will be tailored to the specific needs of every project.

ℹ️ Program goals:
— Encourage the use of swap.coffee APIs, SDKs, and smart contracts;
— Support projects integrating with our platform;
— Strengthen the TON DeFi ecosystem;
— Promote open-source and community-driven development.

ℹ️ In addition to funding, participants may receive:
— Expert consultations;
— Technical audits;
— Integration support;
— Promotion through swap.coffee communication channels.

🚀 Apply here: Grant Program Application

👌 We will review your application and get in touch to discuss the details. Join the swap.coffee Grant Program and help us grow the TON DeFi ecosystem together.

With love, swap.coffee ☕️

✉️ App 🌐 Guide 🤖 Discord 📹 YouTube 🐣 X

UI Widget Update 🎁

🌎 We’ve significantly upgraded the UI Widget Kit. The new version comes with improvements that make integration smoother, expand functionality, and unlock even more use cases:

— Smart Mode;
— Multiswap with custom fee support;
— New token list;
— New liquidity providers;
— Community tokens with display settings.

🎁 The updated documentation is already available. If you have any questions, feel free to join the chat, we’re always here to help: @swapcoffee_dev_chat

With love, swap.coffee 😊

✉ App 🌐 Guide 🤖 Discord 📹 YouTube 🐣 X

⚡️Attention! swap.coffee API usage policy update!⚡️

In light of the growing number of projects actively integrating with our public Rest API — which is awesome, by the way 🥰 — we’ve recently noticed that load distribution across our endpoints became highly unbalanced. Most developers use our API primarily for route construction, which is totally fine. However, we noticed that some projects were excessively using certain resource-intensive parameter combinations — which consume up to 50× more computational resources than average requests — spending almost their entire rate limit on them.

To ensure fair usage and stable performance for everyone, we’re introducing several important changes 🕙

🔒 For all existing free API keys
(does not affect paid keys or requests without tokens — i.e. free 1 RPS access)

In route-building methods
• POST /v1/route
• POST /v1/route/multi
• POST /v1/route/smart
are no longer allowed to specify max_splits > 4 or max_length ≥ 5.

The “smart” route builder POST /v1/route/smart will no longer attempt to search for optimal routes where max_length = 5 (i.e. with three intermediate tokens).

💎 New paid plans

Previously, the minimal paid tier started at 100 RPS for $999/month. Now, we’re introducing two new affordable options:
• 10 RPS — $99/month
• 50 RPS — $499/month

Just as previously, paid API keys may be requested via this form. Additionally, when purchasing a key, you can negotiate special options such as:
• Advanced key features, like the ability to build cyclic routes (e.g., TON → ... → TON), enable indefinite transaction checking even in cases of blockchain downtime, or request extended parameters beyond the standard limits (e.g., max_length = 6).
• Access to a dedicated server pool, ensuring that other users' load doesn't impact your latency when using our services.
• The possibility to deploy your code directly within the route-building engine, or request the development of the required functionality, for executing extreme numbers of requests with minimal delay.

We believe these changes will help keep the ecosystem healthy and fair for all developers, while also offering a smoother upgrade path for those who need higher throughput 🚀

👉 If your service is affected or you’d like to upgrade your API plan, feel free to reach us anytime in our dev chat. 👩‍💻

⚡️Attention! swap.coffee npm package migration!⚡️

Hey everyone 👋 We have an important housekeeping update for those of you integrating with our TypeScript/JavaScript SDKs.

We're migrating all of our npm packages to a new organization scope:

@swap-coffee/* → @swapcoffee/*

Why? 🔨 Due to an internal reorganization of our npm account, we were no longer able to publish under the original swap-coffee scope. Rather than leave you on packages we can't maintain, we've re-published everything under the new swapcoffee org. The good news: the full version history has been preserved, so nothing is lost — the package names are simply changing. ✔️

What you need to do 👨‍💻
Update your dependencies to point at the new scope. In practice:

1. Replace @swap-coffee/... with @swapcoffee/... in your package.json
2. Update any import / require statements accordingly
3. Reinstall:

npm uninstall @swap-coffee/<package>
npm install @swapcoffee/<package>

Everything else — the API, exports, and versioning — stays exactly the same. Just point at the new scope and you're good to go 🚀

⚠️ Please note: the old @swap-coffee/* packages are no longer available — the previous organization has been removed from npm entirely. If your project still references them, your installs and builds will start failing. Please migrate to @swapcoffee/* to restore your builds.

🔒 A note on trust: we know a package suddenly changing its scope can look suspicious — that's a healthy instinct! This migration is 100% official and announced here by the swap.coffee team. If you ever want to double-check the authenticity of anything, just ask us directly in this chat.

Sorry for the minor inconvenience 🙏 If you hit any issues during the migration, or you're unsure whether something is affected, reach out anytime in our dev chat. We're happy to help! ❤️