Telegram bot for transactions using Bitcoin
🧠 Technical Specification: Telegram bot for Bitcoin transactions
🎯 Project Goal
Create a Telegram bot that allows users to independently create, conduct, and complete transactions between two participants using cryptocurrency Bitcoin. Transactions take place in pre-created Telegram groups, links to which are stored in a .txt file. The bot has full permissions in chats and automates the entire process.
🔧 Features
🔘 1. Main bot interface
When the /start command is entered, the bot sends a welcome message and displays a menu with buttons:
Create a transaction
Transaction terms
Contact administrator
🛠️ 2. Creating a transaction
User selects a role:
🟢 I am the customer
🔵 I am the executor
The bot provides a link to the Telegram group and a message with a "Join transaction chat" button, which the user forwards to the second participant.
After both participants join:
The transaction is assigned a unique number
Roles are fixed
A message with transaction stages and Bitcoin wallet is sent and pinned in the chat
📜 3. Transaction stages (in the pinned message)
Discussing terms
Payment by the customer
Fulfillment of terms by the executor
Confirmation of completion by both parties
Payment to the executor
Important:
✅ This message contains the Bitcoin address to which the customer must transfer funds.
— The address should be in a copy-friendly format (one tap in Telegram).
📌 4. Buttons below the pinned message
Transaction conditions and details
Call administrator
Complete transaction
Enter promo code (promo code database in a separate file)
👥 5. Role assignment
Roles are chosen when creating the transaction
The second user does not need to choose anything
The chat records who is the customer and who is the executor
💳 6. Linking Bitcoin wallet
Each transaction is assigned a unique BTC address from a list in a .txt file
After assigning, the address is marked as used
One address — one transaction
Displayed in the pinned message
💰 7. Payment tracking
The bot checks the BTC address balance every minute
When funds arrive:
Notification in chat:
X BTC (~Y USD at current rate) received at address.
Balance updates with partial transfers
Even if the amount is less than agreed, the bot notifies about any receipt
✅ 8. Completing the transaction
When "Complete transaction" is pressed, the bot asks the second participant for confirmation
After two confirmations, the bot requests the executor's Bitcoin address, verifies that the executor sent it, checks the address validity, then makes a transfer of 3% fee and the rest to the executor's address, then generates a transaction receipt
Sends the transaction receipt:
Number
BTC / USD amount
Executor's BTC address
3% fee
Payment TX hash
Payment:
3% — to service address
Remaining — to executor
📌 If one participant disappears, the administrator can manually close the transaction and execute the payout. (i.e., there should be an admin panel to manage transaction fees and prematurely close it)
📦 9. After completion
Message:
Transaction completed. Chat will be deleted in 1 hour. Save materials. (and tag users)
After an hour:
All chat participants except the bot are removed
BTC address is moved to archive
💾 Data storage
In .txt files: (possibly other databases)
List of groups
List of BTC addresses
Address archive
Promo codes
Fee address
Transaction status
Error log
In Google Sheets:
Participant IDs and usernames
Chat IDs
BTC amount
Exchange rate
Fee ($)
TX hash
Transaction time
History and statistics
🔍 Error and event handling
If one leaves the chat — the bot notifies the other and offers to call the administrator
BTC arrives in parts — the bot updates the balance and reports the amount
If one does not confirm completion — the admin can manually close
72 hours of inactivity:
— The bot asks about activity
— If a payment was made — the timer is canceled
— No activity and no payments: warning and deletion after 24 hours
Editing messages:
The bot saves the old and new messages
Shows them in chat (if too long — splits into 2–3 parts)
🔒 Access
All commands and actions are available only to administrators
Users manage the transaction via buttons
Each action checks the administrator's ID
💬 Additional
Promo codes: reduce commission
Anti-flood: message frequency limit
All actions are logged
After restarting, the bot restores unfinished transactions
If fewer than 3 chats remain — notify admins
When possible
Use SQLite/PostgreSQL instead of .txt
Add an admin web panel with transaction filtering
-
Hello. I am ready to make such a bot for you. Write in private messages, and we will discuss the details.
-
Good afternoon, there are reviews on another platform, please write to clarify the price and deadlines, thank you)
-
Hello, I have reviewed the technical specifications. The project is quite interesting and large. I am providing approximate cost and timelines, as I noticed a few points in the specifications that need to be discussed. I have extensive experience in development, including significant experience working with Telegram API. I also have extensive experience working with various blockchain networks.
-
373 👋Good afternoon.
I have experience in developing similar projects and working with cryptocurrency.
I write in Python language, creating bots using the asynchronous library aiogram.
I will help set up and deploy the bot on the server.
Ready to complete your project.
Write to me, I will be glad to cooperate)
-
1182 8 1 Good afternoon, Bogdan
We can set up your store with Bitcoin and connect other currencies if needed.
Write to us, we will discuss functionality, budget, and deadlines.
-
4120 8 0 1 Good day.
Our team XPro is ready to fulfill your order. We have extensive experience in this field. We are sending you our proposal and look forward to your feedback to discuss the details. We hope for further cooperation.
We specialize in the following areas:
- ERP System Development
- CRM System Development
- Website Development of any complexity
- CMS System Development
- Website Support
… - OpenCart Development
- OpenCart Support
- OpenCart Modification
- OpenCart Customization
- WordPress Development
- WordPress Support
- WordPress Modification
- WordPress Customization
- ECommerce Development
- ECommerce Support
- ECommerce Modification
- ECommerce Customization
- Web Application Development
- 1C Server Support
- Web Server Support
- Mobile Application Development
and on these technologies:
- Python
- PHP
- Laravel
- Symfony
- Yii2
- JS
- NodeJS
- jQuery
- TypeScript
- MySQL
- HTML
- CSS
- Vue
- Nuxt.js
- React
- React Native
- C++
-
655 4 0 Hello, I am ready to make such a bot, thank you for the detailed technical assignment, write to me and we will do it.
-
9944 117 0 Hello.
I am developing bots for Telegram on NodeJS. Ready to take on the project. Write to me, let's discuss.
-
95670 1272 1 10 Hello. I have extensive experience in developing Telegram bots. Ready to cooperate
-
198 Good afternoon, we are a team of programmers developing similar projects, we can do it quickly because we have experience in this, we can have a call or chat privately.
-
8753 60 0 1 Hello! SolidWay is ready to help with creating a Telegram bot for Bitcoin transactions. We have experience developing complex bots that automate the process and simplify interaction between users. We understand all aspects of your project and are confident that we can implement it at a high level.
Our team has already worked on similar projects, including integration with cryptocurrencies and creating a user-friendly interface. We will pay close attention to details to ensure that each function works smoothly and without errors. We will provide the necessary security and comfort for users.
Let's discuss more details so we can better understand your requirements and offer optimal solutions. We will determine the timeline and budget after a more in-depth analysis of the task.
-
Еще актуально?
-
Current freelance projects in the category Bot Development
Development of a Telegram store for a clothing brand. Product catalog, sizes, cart, order processing.
178 USD
A Telegram channel is needed with a warehouse from the KCRM system, showing stock balances, and full payment to the IBAN account. Bot Development ∙ 1 hour 48 minutes back ∙ 38 proposals |
Software maintenance
111 USD
It is necessary to make adjustments to the software and maintain it in the future; the software places orders based on specified parameters and sends them to a Telegram bot. Python, Bot Development ∙ 20 hours 42 minutes back ∙ 52 proposals |
Telegram bot
269 USD
It is necessary to completely replicate the interface and functionality, but without the payment platform. It needs to be done in a short time. Bot Development ∙ 1 day 18 hours back ∙ 109 proposals |
Automatic video posting on social media according to a scheduleTechnical Assignment (TA) Automatic video publication on social media according to a scheduleProject Description A script/bot (Python preferred, or any other solution of your choice — the main thing is stability and ease of maintenance) is needed, which automatically publishes… Python, Bot Development ∙ 1 day 20 hours back ∙ 56 proposals |
Bot for receiving/searching applications
28 USD
In short: Create a bot where users can create and find profiles, the bot should have referral links, etc. Everything is detailed below. Client-side bot: Before the /start button, text in the center of the chat: What can this bot do? Welcome to Sugar Secret Agency! -Premium… Python, Bot Development ∙ 1 day 22 hours back ∙ 61 proposals |