# Getting Started {% embed url="" %} ## What is it? Definest is a service for finding profitable crypto wallets and a copy trading bot for automatically replicating the trades of these wallets. ## Registration To register on Definest, you will need to enter: * Email * Password * [Invitation code](/welcome/invitation-codes) Then, an email will be sent to the address you provided. Click the link in the email to confirm your account. ## How to Find Successful Wallets? 1. Go to the [Wallets](https://definest.ai/wallets) page. 2. Click on Wallet filter. 3. Choose one of the Standard filters or create your own filter and apply it. 4. Next, go to the wallet pages and select successful wallets based on the parameters of the Original wallet and the Followed wallet (bottom row). 5. If the parameters are satisfactory for you, save the wallet address. ## **How to automatically copy trades from successful wallets?** 1. Go to the Copy [CopyTrading bot](https://definest.ai/trading/bot) page. 2. Click Add trading wallet to create a new wallet from which trading will be conducted. 3. Enter a name for the wallet. 4. Paste the Private key to import your wallet and click Import wallet, or click Generate a new wallet to create a new wallet. 5. In the Wallet to follow block, specify the address of the wallet to replicate trades. 6. Adjust all parameters according to your requirements. For more details on[ bot settings](/copy-trading-bot/bot-settings.). 7. Fund the wallet with a minimum of 0.1 ETH. # Invitation codes Definest.ai is a closed service; you cannot register without an invitation. Invitations can be obtained from people who already have an account on the Definest website. Invitations are also sometimes issued: * In our [Telegram channel](https://t.me/definest_ai) * In our [Telegram group](< https://t.me/+zUj_adwqWK9hOTg0>) # Contest Hub ## Welcome to Definest Contests Here you’ll find every live and finished contest we run—trading challenges, referral races, leaderboard sprints, and more. Jump in, test your skills, and compete for cash, credits, exclusive perks, and early-access features.
### Why join? * Real prizes. From USDT payouts to free premium months and VIP upgrades. * Bragging rights. Earn your spot on the global leaderboard and showcase your wallet’s performance. * Fresh challenges. New themes drop regularly—copy-trading accuracy, ROI marathons, fastest sniper wins, you name it. * Instant feedback. Track your ranking in real time and see how you stack up. ### **Current Contests** Browse the active competitions below: {% hint style="info" %} There are no contests at the moment. {% endhint %} *** ### Completed **Contests** Browse the active competitions below:

Contest #1

https://docs.definest.ai/contest-hub/definest-video-contest-1/files/7idz7pwvCz5T6h87v8QS
# Definest Video Contest #1
## Quick Facts
Contest window9 May – 10 July 2025 (23:59 CET)
Eligible networksSolana (main focus)
Video length7 – 25 minutes
LanguageAny
Total prize pool4 000 USDT + perks
SupportTelegram @Definest_Support
## 1 Overview Definest.ai is launching its first community‑driven Video Contest. Create a concise YouTube tutorial, case study or review that demonstrates how you copy‑trade on Solana via Definest, share it with your audience using your personal referral link, and compete for juicy rewards. ## 2 Prizes 💰 | | | | -------------------- | ------------- | | 🥇 1st | 1 500 USDT | | 🥈 2nd | 1 000 USDT | | 🥉 3rd | 500 USDT | | 🎖 4 – 10th | 200 USDT each | | 🎁 Participant bonus | 15 USDT | {% hint style="success" %} Tip: More viewers → more referrals → higher score! {% endhint %} ## 3 Timeline 🗓 | Milestone | Date (2025) | | ----------------------------- | --------------------- | | Contest announcement | **9 May** | | **Deadline for submissions** | **10 July 23:59 CET** | | Metrics snapshot | 16 July 12:00 CET | | Winners revealed (livestream) | 17 July | | Prize distribution | **20 July** | ## 4 Video Requirements 1. **Title** must contain the words “Copy Trading”, “Solana”, “Definest” (any order/language). 2. **Length:** 7–25 minutes. 3. **Content focus:** show real workflow with Definest.ai on Solana — how to find profitable Solana wallets, set up and filter strategies, and configure the bot to follow them. 4. **Description** must include: 1. your unique referral link ; 2. at least two occurrences of the keywords Copy Trading, Solana, Definest; 3. hashtags #Definest #CopyTrading #Solana (recommended). 5. **Quality:** 720p HD+, clear audio, no copyrighted third‑party materials without permission. 6. Video must be **publicly accessible** on YouTube, not “Made for Kids”, and free of regional restrictions. ## 5 How to Enter 1. Record and publish your video on YouTube following the requirements above. 2. Fill out the submission form: 1. YouTube video URL 2. Email address of your Definest account (visible in your account) 3. Wallet address (USDT TRC20) for payout 4. Telegram handle (e.g., @username) 3. Submit **before 10 July 23:59 CET**. Your referral link is available at ## 6 Judging Criteria | Category | Weight | | ---------------------------------------------------------------------------- | ------ | | **Content quality & clarity** | 30 % | | **Accuracy & completeness** (features, fees, risks) | 20 % | | **Creativity & engagement** | 15 % | | **YouTube performance** (views, watch‑time, likes/comments) | 25 % | | **Referral impact** (users who purchase Premium or use the Copy Trading Bot) | 10% | Judges: Definest core team + invited crypto YouTubers. ## 7 Terms & Conditions (TL;DR) * By entering, you grant Definest a non‑exclusive right to feature your video (with attribution) in marketing. * Any artificial inflation of views, likes or referrals will lead to disqualification.\ No financial advice or promises of guaranteed profit within the video. * Taxes are the sole responsibility of the winners. * Definest may adjust dates or rules in case of force majeure (we will notify ≥ 48 h in advance). ## 8 Resources * **Product docs:** * Sample referral link builder: ## Need help? Ping [@Definest\_Support](https://t.me/Definest_support) in Telegram.\ Ready, set, record — and flood YouTube with Solana copy‑trading alpha! *** ## Results The first Definest Video Contest is complete, and every prize has already been paid out to the wallets provided in the submission forms. Thank you to everyone who shared their real-world Solana copy-trading workflows and helped new users discover Definest! ### **Top 10 Winning Videos**
PlacePrizeVideo
1 🥇1 500 USDThttps://youtu.be/IdNiLBdao-k
2 🥈1 000 USDThttps://youtu.be/GCJ9fjaC3SQ
3 🥉500 USDThttps://youtu.be/IXCRFVgWON0
4 🎖200 USDThttps://youtu.be/mXhU1IdELsk
5 🎖200 USDThttps://youtu.be/fMnkHVDehok
6 🎖200 USDThttps://youtu.be/83SQfc5JJ6E
7 🎖200 USDThttps://youtu.be/LTFx3c6iGbQ
8 🎖200 USDThttps://youtu.be/Jb9rijP17TE
9 🎖200 USDThttps://youtu.be/M5iMJirMTzo
10 🎖200 USDThttps://youtu.be/5rF_4QD2jAA
**🎁 Every other qualifying creator just received 15 USDT or 1-month Pro — congrats!**\ \ **🔍 How we calculated the scores**\ • Content quality & clarity – 30 %\ • Accuracy & completeness – 20 %\ • Creativity & engagement – 15 %\ • YouTube analytics (views, watch-time, likes/comments) – 25 %\ • Referral impact (Premium buyers / Bot users) – 10 %\ \ ❌ Two videos broke the rules and, sadly, were disqualified.\ \ Massive THANK YOU for filling YouTube with Solana copy-trading magic and showing the power of Definest. Stay tuned — our next, even bigger contest is right around the corner! 🚀 # Copy of Definest Video Contest #1
## Quick Facts
Contest window9 May – 10 July 2025 (23:59 CET)
Eligible networksSolana (main focus)
Video length7 – 25 minutes
LanguageAny
Total prize pool4 000 USDT + perks
Submission form👉 Google Form
SupportTelegram @Definest_Support
## 1 Overview Definest.ai is launching its first community‑driven Video Contest. Create a concise YouTube tutorial, case study or review that demonstrates how you copy‑trade on Solana via Definest, share it with your audience using your personal referral link, and compete for juicy rewards. ## 2 Prizes 💰 | | | | -------------------- | ------------- | | 🥇 1st | 1 500 USDT | | 🥈 2nd | 1 000 USDT | | 🥉 3rd | 500 USDT | | 🎖 4 – 10th | 200 USDT each | | 🎁 Participant bonus | 15 USDT | {% hint style="success" %} Tip: More viewers → more referrals → higher score! {% endhint %} ## 3 Timeline 🗓 | Milestone | Date (2025) | | ----------------------------- | --------------------- | | Contest announcement | **9 May** | | **Deadline for submissions** | **10 July 23:59 CET** | | Metrics snapshot | 16 July 12:00 CET | | Winners revealed (livestream) | 17 July | | Prize distribution | **20 July** | ## 4 Video Requirements 1. **Title** must contain the words “Copy Trading”, “Solana”, “Definest” (any order/language). 2. **Length:** 7–25 minutes. 3. **Content focus:** show real workflow with Definest.ai on Solana — how to find profitable Solana wallets, set up and filter strategies, and configure the bot to follow them. 4. **Description** must include: 1. your unique referral link ; 2. at least two occurrences of the keywords Copy Trading, Solana, Definest; 3. hashtags #Definest #CopyTrading #Solana (recommended). 5. **Quality:** 720p HD+, clear audio, no copyrighted third‑party materials without permission. 6. Video must be **publicly accessible** on YouTube, not “Made for Kids”, and free of regional restrictions. ## 5 How to Enter 1. Record and publish your video on YouTube following the requirements above. 2. Fill out the submission form: 1. YouTube video URL 2. Email address of your Definest account (visible in your account) 3. Wallet address (USDT TRC20) for payout 4. Telegram handle (e.g., @username) 3. Submit **before 10 July 23:59 CET**. {% hint style="warning" %} **Submit now:** [**Google Form**](https://docs.google.com/forms/d/e/1FAIpQLSchlyLRP4UNIPkyzX-4KOmZhXRA9FYzWiyhfL8-11EYwwcazg/viewform?usp=sharing) {% endhint %} Your referral link is available at ## 6 Judging Criteria | Category | Weight | | ---------------------------------------------------------------------------- | ------ | | **Content quality & clarity** | 30 % | | **Accuracy & completeness** (features, fees, risks) | 20 % | | **Creativity & engagement** | 15 % | | **YouTube performance** (views, watch‑time, likes/comments) | 25 % | | **Referral impact** (users who purchase Premium or use the Copy Trading Bot) | 10% | Judges: Definest core team + invited crypto YouTubers. ## 7 Terms & Conditions (TL;DR) * By entering, you grant Definest a non‑exclusive right to feature your video (with attribution) in marketing. * Any artificial inflation of views, likes or referrals will lead to disqualification.\ No financial advice or promises of guaranteed profit within the video. * Taxes are the sole responsibility of the winners. * Definest may adjust dates or rules in case of force majeure (we will notify ≥ 48 h in advance). ## 8 Resources * **Product docs:** * Sample referral link builder: ## Need help? Ping [@Definest\_Support](https://t.me/Definest_support) in Telegram.\ Ready, set, record — and flood YouTube with Solana copy‑trading alpha! # Wallets page {% embed url="" %} ### About the Wallets page In this section, the site searches for successful crypto wallets. The Wallets page displays a list of the found wallets.
Each wallet has two rows of indicators - the upper and lower rows. By default, the upper row displays the parameters of the original wallet, while the lower row shows the calculated parameters for following this wallet.
To start your search, you need to select a filter to look for wallets. To do this, click on Wallet filter (the blue icon).
In the opened modal, you can choose either one of the Standard filters or create your own filter. Standard filters depend on your Pricing plan and cannot be edited. The higher your pricing plan, the better the Standard filters will be. Instructions on how to create your own filters can be found in the [Wallet filters](/wallet-search/creating-a-wallet-filter) section. \ To select a filter, click the circle to the left of the name. After that, a table of wallets that match these parameters will be displayed.
# Interface settings The wallet table can be sorted by any column (PnL 24h, ROI 7d, etc.). The displayed columns (PnL, WinRate, ROI, etc.) can be fully customized. To do this, click on Interface settings and mark the period for which you want each parameter to be displayed.
Using the "Change position" switch, you can swap the upper and lower rows of a wallet. By default, the upper row displays the parameters of the original wallet, while the lower row shows the calculated parameters for following this wallet. # Creating a wallet filter The platform is designed to allow you to create the most unique filters by combining different parameters over various time periods. It is truly a professional tool for finding successful crypto wallets. ## How to create filters 1. Click on Wallet filter (the blue icon). 2. Click Add filter.
3. Come up with a name for your new filter, such as New filter #1. 4. In the right column, you’ll find the filters. Select the parameters you are interested in and click the plus sign to add them.
For example, choose PnL Realized (in the Original block). Next, you’ll need to select the time period for which the PnL Realized parameter is calculated, such as 24 hours. Then specify the Min and/or Max values.
As a result, you will have: Find all wallets where the realized profit in the last 24 hours was at least $1000.
5. Filters are divided into Original and Following. Original filters pertain to the original wallet, while Following filters relate to the calculated indicators for following the wallet.\ \ With Original filters, you can find successfully trading wallets.\ With Following filters, you can find wallets that you can successfully copy trades from. A wallet that trades successfully does not always guarantee that you will also trade successfully by following it.
6. Let's add the Following filter for PnL Realized over 24 hours with a Min parameter of $800.
Now, the system will filter all wallets where the realized profit in the last 24 hours was at least $1000, and the calculated realized profit for following this wallet over 24 hours was at least $800.
7. You can use the same parameter with different time intervals to filter out the most successful wallets.
Next, it all depends on the filters you create. ## Cost in Credits Searching for wallets is a paid action. Payment is made in Credits: * One search costs 5 credits per day or until the filter is changed. * Each subsequent search results page also costs 5 credits per day. Credits for the previously opened page are not deducted. You can go back to previous pages and refresh the page for free. For more details about [Credits and pricing plans](/miscellaneous/credits-and-pricing-plans). # Filters list Here, all the filters and their meanings are described. ## Original and Following filters In our service, all filters are available in two versions: **Original** and **Following**.
* **Original filters** relate to the performance metrics of the original wallet. * **Following filters** pertain to the calculated indicators when you follow or copy the trades of the original wallet. **Using Original filters**, you can find wallets that are trading successfully based on their own performance. **Using Following filters**, you can identify wallets whose trades you can successfully replicate. It's important to note that a wallet trading successfully doesn't always guarantee that you will achieve the same success by copying their trades. Market conditions, timing, and other factors can affect the outcomes when trades are replicated. Therefore, **Following filters** help you find wallets that not only trade successfully but also have trading strategies that are more likely to yield positive results when followed. This distinction ensures that you choose wallets that increase your chances of successful trading when you replicate their trades. ## PnL Realized Realized Profit and Loss is the actual profit or loss from completed trades. This is the money you’ve actually made or lost after closing trades. It shows the real outcome of your trading, not including open trades. Example: You bought cryptocurrency for $100 and sold it for $150. Your realized profit is $50. Units of Measurement: US dollars ($). ## PnL Unrealized Unrealized Profit and Loss is the potential profit or loss from open trades that haven’t been closed yet. This is the money you could make or lose if you closed your current trades right now. It shows how much you’ve potentially gained or lost so far. Example: You bought a coin for $100, it’s now worth $120. Your unrealized profit is $20. Units of Measurement: US dollars ($). ## PnL Total Total Profit and Loss is the combined profit or loss from all trades, both closed and open. This is the total amount of money you’ve made or lost from all trades. It includes both Realized and Unrealized results. Example: Realized profit is $50, Unrealized profit is $20. Total PnL is $70. Units of Measurement: US dollars ($). ## Median PnL Realized Median Realized Profit and Loss is the middle value of profits from completed trades when ordered. This is the typical amount you usually make on closed trades. It helps understand what result happens most often. Example: Trades with profits of $10, $20, **$30**, $40, $50. Median profit is $30. Units of Measurement: US dollars ($). ## ROI Realized Realized ROI is the percentage of profit from completed trades compared to the invested amount. Shows how much percent you’ve made or lost from the money invested in closed trades. Assesses investment efficiency. Example: Invested $100, got $150 back. Realized ROI is 50%. Units of Measurement: Percentage (%). ## ROI Unrealized Unrealized ROI is the potential percentage profit or loss from open trades compared to the invested amount. Shows what percent you could make or lose if you closed open trades now. Helps understand current profitability. Example: Invested $200, now worth $220. Unrealized ROI is 10%. Units of Measurement: Percentage (%). ## ROI Total Total ROI is the cumulative percentage of profit or loss from all trades relative to the invested funds. Overall percentage showing how much you’ve made or lost from all investments. Includes closed and open trades. Example: Invested $500, earned $50 (10%), open trades add $25 (5%). Total ROI is 15%. Units of Measurement: Percentage (%). ## Median ROI Realized Median Realized ROI is the middle percentage profit from completed trades when ordered. Typical percentage profit you usually get on closed trades. Helps understand what result occurs most often. Example: Trade ROIs: 5%, 10%, 15%, 20%, 25%. Median ROI is 15%. Units of Measurement: Percentage (%). ## ROI High ROI High is the highest ROI observed in a trade. For a wallet, ROI High is the sum of all the highest ROIs from the trades. This is the highest percentage profit you’ve seen in a single trade. For the entire wallet, it’s the sum of these highest percentage profits from each trade. Example: In one trade, ROI reached 50%. If you have three such trades, the wallet’s ROI High is 150%. Units of Measurement: Percentage (%). ## ROI Low ROI Low is the lowest ROI observed in a trade. For a wallet, ROI Low is the sum of all the lowest ROIs from the trades. This is the lowest percentage profit (or biggest loss) you’ve seen in a single trade. For the wallet, it’s the sum of these lowest percentage profits from each trade. Example: In one trade, ROI was -30%. If you have three such trades, the wallet’s ROI Low is -90%. Units of Measurement: Percentage (%). ## WinRate Realized Realised Win Rate is the proportion of profitable closed trades out of all closed trades. Shows what percentage of your completed trades made money. Assesses trading effectiveness. Example: Out of 10 closed trades, 7 were profitable. Win Rate Realised is 70%. Units of Measurement: Percentage (%). Min / Max value: from 0% to 100%. ## WinRate Unrealized Unrealised Win Rate is the proportion of profitable open trades out of all open trades. Shows what percentage of your current trades are making money. Helps understand your portfolio’s current state. Example: Out of 5 open trades, 3 are profitable. Win Rate Unrealised is 60%. Units of Measurement: Percentage (%). Min / Max value: from 0% to 100%. ## WinRate Total Total Win Rate is the proportion of all profitable trades (closed and open) out of all trades. Shows what percentage of all your trades are making money. Includes both completed and ongoing trades. Example: Out of 15 trades, 9 are profitable. Total Win Rate is 60%. Units of Measurement: Percentage (%). Min / Max value: from 0% to 100%. ## Trades Count Trades Count is the total number of trades made, including closed and open. This is the total number of all your trading activities. Helps assess your experience and activity level. Example: You’ve made 20 trades in a month. Trades Count is 20. Units of Measurement: Quantity (number of trades). Min / Max value: Minimum is 0 (if no trades) ## Scam Trades Scam Trades is the percentage of trades involving scam projects out of all trades. Shows what percentage of your trades involved fraudulent crypto projects. Helps assess the riskiness of your investments. Example: Out of 100 trades, 5 were scams. Scam Trades is 5%. Units of Measurement: Percentage (%). Min / Max value: from 0% to 100%. ## Trade Duration Trade Duration is the average duration of open trades before closing. Shows how long, on average, you hold trades. Helps understand your trading style. Example: Trades lasted 1, 30, and 60 minutes. Avg Time is 30 minutes. Units of Measurement: minutes. Min / Max value: from 0 to ∞. ## Liquidity Liquidity is the median value of the liquidity of traded coins when ordered. Liquidity shows how easily a coin can be bought or sold. Median liquidity helps understand which coins you usually trade. Example: Coin liquidities: $1M, $2M, $3M. Median Liquidity is $2M. Units of Measurement: US dollars ($). Min / Max value: from 0 to ∞. ## Tokens Age Tokens Ageat the time of trade opening is the typical age of the coins in your portfolio at the time of purchase. Shows how long the coins you buy have been around at the moment you make the purchase. Helps understand if you’re investing in new or established projects. Example: You buy coins that have existed for 60 minutes, 120 minutes, and 180 minutes. The median age at purchase is 120 minutes. Units of Measurement: minutes. Min / Max value: from 0 to ∞. ## First Buy Amount First Buy Amount is the typical amount you spend on the first purchase in a trade. Shows how much you usually invest when entering a new trade. Helps understand your standard initial investment size. Example: First buys: $100, $200, $300. Median amount is $200. Units of Measurement: US dollars ($). \ Buy Amount ---------- Buy Amount is the typical amount you spend on purchases in trades. Shows how much you usually spend when buying assets. Helps understand your standard investment size. Example: Buys of $150, $250, $350. Median amount is $250. Units of Measurement: US dollars ($). Min / Max value: from $0 to ∞. ## Trading Start Date Trading Start Date is the date range when the original wallet started trading. Specified in the format “from date to date”. This is the period during which the original wallet first began making trades. Helps understand how long the wallet has been active in the market. Example: The wallet started trading from January 1, 2021, to December 31, 2021. Units of Measurement: Dates (e.g., from 01.09.2023, to 31.05.2024). Min / Max value: from [Cut-off date](/miscellaneous/cut-off-dates) to today ## Trading Start Window Trading Start Window is the time range when the original wallet started trading. Specified in the format “from X to Y days ago”. This is a period in the past during which the wallet began its trading activity. Helps determine the wallet’s level of experience. Example: The wallet started trading from 30 to 60 days ago. Units of Measurement: Days. Min / Max value: from [Cut-off date](/miscellaneous/cut-off-dates) to today ## Closed Trades Closed Trades is the percentage of completed trades out of all trades. Shows what percentage of your trades have been completed (closed). Helps assess your trading activity and style. Example: Out of 100 trades, 80 are closed. Closed Trades is 80%. Units of Measurement: Percentage (%). Min / Max value: from 0% to 100%. ## Capital Required This is the amount of money you need to replicate the original wallet’s trades, considering reinvestments. It’s the amount you need to invest to copy another wallet’s trades, including reinvesting profits. Example: To replicate the wallet’s trades, you need to invest $10,000. Units of Measurement: US dollars ($). Min / Max value: from $0 to ∞. ## Max Drawdown Max Drawdown is the largest drop in your portfolio value from peak to trough. Shows how much your investments have decreased in value. Helps assess risk and volatility. Example: Portfolio rose to $10,000, then fell to $7,000. Drawdown is 30%. Units of Measurement: Percentage (%). Min / Max value: from 0% to 100%. ## Sharpe Ratio In our case, the Sharpe Ratio reflects wallets that are the best to successfully copy trades from. It’s a metric that helps you choose wallets whose trades are most profitable to copy, considering risk and return. Example: A wallet with a Sharpe Ratio of 1.0 is considered more attractive to copy than one with 0.5. Units of Measurement: Ratio (dimensionless). ## Top Deal Percentage Realized Top Deal Percentage Realized shows what percentage of your total realized profits comes from your single most profitable trade. The closer this value is to 100%, the more one deal dominates your overall gains. High value (close to 100%): One trade contributed almost all of your profits. Low value (close to 0%): Profits are spread more evenly across multiple trades. Value > 100%: One trade contributed more profit than your net total because other trades lost money, so that single winning trade’s share exceeds 100 %. Value < 0 %: You had a winning trade, but combined losses on other trades made your net profit negative, so dividing the top positive trade by a negative total gives a negative percentage. Example: Suppose you closed three trades with profits of $100, $50, and $25. Your total realized profit is $175, and the top deal was $100. Top Deal Percentage Realized = $100 / $175 ≈ 57%. If instead your trades were $100, $1, and $1, then total = $102, top deal = $100, and Top Deal Percentage Realized ≈ 98%—meaning that nearly all profit came from that one trade. ## Top Deal Percentage Total Top Deal Percentage Total is the same like [Top Deal Percentage Realized](https://docs.definest.ai/wallet-search/filters-list#top-deal-percentage-realized), but computed for Total Profit of all deals ## Profit Linearity Profit Linearity shows how closely the cumulative growth of profits from closed trades follows a perfect “straight‐line” trend. The closer it is to 1, the more evenly and predictably your profits have grown. High value (close to 1): Each successive trade added profit at roughly the same rate—no big “jumps” or “flat periods.” Low value (close to 0): Your total profits were generated unevenly, mostly driven by a few large trades rather than steady, gradual gains. Example: Suppose you have three closed trades with profits of $100, $100, and $100. Then the cumulative profits are $100, $200, $300. These points lie exactly on a straight line, so Profit Linearity = 1. If, instead, your profits were $50, $250, and $0, the cumulative points ($50, $300, $300) do not lie on one straight line, and Profit Linearity would be lower (for instance, around 0.70–0.80). Min / Max value: From 0 to 1. # Wallet page The Wallet page is a page with detailed information about a specific wallet. For example, let’s take the wallet [0xb5f6fc...c00e1d4bd](https://definest.ai/wallet/0xb5f6fcd9002dd6320b404ae80e6a814c00e1d4bd). ## ## Wallet Balance The first thing we see is two balances: * The total wallet balance, including all coins in the selected network. * The Ethereum balance, which indicates how much ETH is held in this wallet. By checking the balance, you can determine whether the wallet is still active or if funds have been withdrawn. **To the right of the balance, there is a Z button that links to the Zerion service with this wallet. In this service, you can view more details about the balance and transactions.**
## **Overview of Parameters** Next is a table showing the indicators of the original wallet (upper rows) and the calculated indicators for following the wallet (lower rows). The parameters (PnL, ROI, Winrate, etc.) are listed on the left, while the time intervals (24h, 7d, 1m, etc.) are displayed at the top. All of this can be configured using the Interface settings button located at the top of the page.\ From this table, you can already draw conclusions about the profitability of the wallet and estimate whether you will be able to successfully replicate trades, as well as how much money you will need to follow, how frequently trades occur, etc.
## **PnL Chart** The PnL chart for the original wallet displays: * Green line - PnL of the original wallet * Blue line - PnL of the following wallet By default, the chart shows data for the past year. However, you can change the time frame below the chart.
## Trades A trade consists of a buy transaction, approval, and sale (as well as the corresponding calculated following operations). A trade remains in the Open status until 100% of the purchased coins are sold.
Each trade consists of two rows: the upper row displays the actual performance of the original wallet’s transaction, while the lower row shows the calculated performance of the transaction if we had followed this wallet.
**Trade Statuses:** * **Open** - There is a purchase, but no sale has occurred, or less than 100% of what was purchased has been sold. * **Closed** - 100% of what was purchased has been sold. * **Scam** - The coin is fraudulent. There can be many reasons for this: liquidity withdrawal, honeypot, etc. Unfortunately, not all scam coins are marked with this status. We continue to improve the identification of such tokens. * **Oversell** - More coins have been sold than purchased. This can happen when additional tokens are sent to the wallet from external sources. Therefore, such operations may appear very profitable but are actually incorrect. The columns with trade indicators can be customized in Interface Settings under the Trades settings section. {% hint style="info" %} Trades may contain errors! If you find an error, please report it to us using the **Send a Report** button in the three-dot menu on the right. ![](/files/WlfGMgjDG2edZ4WVYKKV) {% endhint %} ## **Operations in a Trade** Each trade can be expanded to see the operations it consists of: * **BUY** - Purchase of the token by the original wallet * **f BUY** - Calculated purchase of the token while following the wallet * **APPROVE** - Operation granting permission to a smart contract or dApp to use your tokens * **f APPROVE** - Calculated operation granting permission to a smart contract or dApp to use your tokens * **SELL** - Sale of the token by the original wallet * **f SELL** - Calculated sale of the token while following the wallet
In addition, you can expand each operation to see the details of the exchange. Here, you can view: * **Coin Fee** * **Router Fee** * **Network Fee** * **Router** * **Application** * **Transaction hash** * **Swaps**
## Search by Token Address or Name
Use the search by token address or name to quickly find the desired operation. ## Time period
Use the Time period feature to calculate all wallet indicators only for the specified time frame. This can be useful if you want to assess how successful the wallet was over a certain period and compare that data with the current period. In this way, you can train your ability to predict the success of a wallet based on historical data. ## **Cost in Credits** Viewing one wallet page costs 1 credit per day. This means you can refresh the wallet page within a day without incurring additional charges. For more details about [Credits and pricing plans](/miscellaneous/credits-and-pricing-plans). Interface settings # Interface settings wallet page With the Interface Settings, you can fully customize the Wallet page to suit your preferences. To open the interface settings, click the Interface settings button at the top of the page.
You will see the following popup window with settings. ## **Change position** This option allows you to swap all indicators of the original wallet with the calculated indicators for following the wallet on the page. By default, the upper row displays the indicators of the original wallet.
## **PnL etc Columns & Rows** In this section, you can choose which indicators to display in the table and for which time intervals. In the **PnL etc columns** section, you can configure the time intervals for all indicators. In the **PnL etc rows** section, you can customize which specific indicators you want to see in the table, such as PnL Total, Winrate Total, etc.
## Investment amount graph
This section includes an additional chart. This chart shows how much money you would have needed to fully follow the original wallet at any given moment in time, taking into account the reinvestment of profits. ## Trades settings
In this section, you can customize the columns that are displayed in the Trades section. # Bot overview ## Introduction Welcome to the Definest [copy trading bot](https://definest.ai/trading/bot)! With this bot, you can automatically follow (copy trades) successful wallets. This bot has been specifically designed for copy trading. We have done everything possible to ensure that you earn the highest profit while following wallets. {% hint style="info" %} For more details about supported chains and DEXs, [click here](/miscellaneous/supported-chains-and-dexs). {% endhint %} With this guide, you will master the art of following successful crypto wallets. ## Bot Overview
Take a look at the bot image above. Each row represents a separate bot. You can also group bots together to view overall statistics. For more details about groups, [click here](/copy-trading-bot/bot-groups). Now let’s discuss the columns. ### **Name** This is the name of the bot/wallet or group of bots/wallets. ### **Status** * **Buy** - If this switch is on, the bot will copy purchases from the original wallet. * **Sell** - If this checkbox is checked, it means one of the two settings, Copy Sell or Auto Sell, is enabled. * **Balance** - The total amount of all tokens in your wallet/bot in dollars. * **ETH** - The amount of ETH and WETH in your wallet/bot in dollars. ### **Errors** Errors that occurred in the bot over the specified time period. If you see in the Errors column **24h - 10 (+5)**, it means there were 10 errors in the bot in the last 24 hours, of which 5 are new, unreviewed errors. ### **PnL** PnL is the combined profit or loss from all trades, both closed and open. This is the total amount of money you’ve made or lost from all trades, including both Realized and Unrealized results. Example: Realized profit is $50, Unrealized profit is $20. Total PnL is $70. ### **ROI** Total ROI is the cumulative percentage of profit or loss from all trades relative to the invested funds. It shows the overall percentage of how much you’ve made or lost from all investments, including closed and open trades. Example: Invested $500, earned $50 (10%), open trades add $25 (5%). Total ROI is 15%. ### **WinRate (Total)** Total Win Rate is the proportion of all profitable trades (closed and open) out of all trades. It shows what percentage of all your trades are making money, including both completed and ongoing trades. Example: Out of 15 trades, 9 are profitable. Total Win Rate is 60%. **(Total) - Total Trades**\ This is the total number of trades made, including closed and open. It reflects the total number of all your trading activities. # Bot settings. ## **Creating a New Bot/Wallet** 1. Click the blue **Add trading wallet** + button. 2. Come up with a name for your wallet/bot. 3. If you want to import your already created wallet, paste the Private key and click **Import wallet**.\ \ If you want to create a new wallet, simply click **Generate a new wallet**. 4. Choose a network from the dropdown (Ethereum, Solana, etc.). 5. If you choose **Generate a new wallet**, make sure to copy and securely store the Address, Private Key, and Mnemonic of the new wallet. 6. The wallet is created; click **Next**. ## **Bot Settings** Next, you will proceed to the settings for the created bot. ## My trading bot
* **Bot name** - Any name to help you identify this bot. * **Trading wallet** - The wallet this bot uses to trade and hold funds. You can change it at any time using the Change button. * **Network** - The blockchain network where this bot operates. * **Trade with** - selects the quote currency the bot uses (per network). * Solana: USDC or SOL * Ethereum: USDT or ETH When you switch it: * Orders are placed as TOKEN/USDC or TOKEN/SOL on Solana, and TOKEN/USDT or TOKEN/ETH on Ethereum. * All amounts and limits in Buy and Advanced are interpreted in the selected quote currency. * The bot spends the matching wallet balance (USDC/USDT/ETH/SOL). The \~ … hints show the approximate value in the other currency. * There’s no auto-conversion — if you don’t have enough of the selected currency, the trade won’t execute. * It affects: Buy amount (Min/Max), Dupe buy amount (Min/Max), Max position per trade (Max position / Min buy amount). ## Copy trade * **Wallet address** - The address of the wallet you will be following (to copy its trades). * **Wallet name** - Come up with a name for the wallet you will be following.
## Buy ### Copy Buy This is the main setting that enables copying purchases from the original wallet. If this setting is turned off, the bot will not make any purchases. {% hint style="success" %} Enable this setting for the bot to be able to buy tokens. {% endhint %} ### Dupe Buy If this setting is enabled, the bot is allowed to buy additional amounts of a token that has already been purchased (i.e., there is an open trade). ### Buy percentage Buy Percentage is a parameter that determines the portion of funds allocated to purchasing cryptocurrency when copying the trades of the original wallet. It allows traders to adjust the size of their investments relative to the trades made by the original wallet. **Min/Max Values:** From 1% to 1000%. This means that a trader can invest from 1% to 1000% of the amount that the original wallet spends on purchasing a specific asset. Additionally, the purchase amount cannot be less than Min ETH and more than Max ETH. Buy Percentage allows you to control how aggressively or conservatively you want to follow the original wallet. For example, if the original wallet invests $1,000 in buying Bitcoin and your Buy Percentage is set to 100%, you also invest $1,000. If your Buy Percentage is set to 200%, you invest $2,000, doubling your exposure compared to the original wallet. However, it’s important to note that the purchase amount cannot be less than Min ETH and more than Max ETH, ensuring that you adhere to the minimum and maximum investment limits set by your platform. ### Buy amount Specify the Minimum and Maximum amounts for the first purchase in the token's native currency. {% hint style="info" %} The bot will purchase the same amount of currency as the original wallet, but no less than the Min and Max values you have set. {% endhint %} Please note that sometimes smart contracts have restrictions on the maximum purchase amount for newly created tokens. If you exceed this limit, a purchase error will occur. ### Retry times In case of an error during a purchase, the bot will attempt to buy the token as many times as specified here. Recommended value for Ethereum: 10. Recommended value for Solana: 2. Max: 5. ### Copy Gas (ETH) When enabled, the gas amount for your purchase will include the gas used by the original wallet in the copied purchase. ### Copy Priority Fee (SOL) When this option is on, the bot uses the priority fee paid by the original wallet plus the extra amount you entered in the *Priority Fee* field. {% hint style="success" %} **Final priority fee** = **Original wallet’s priority fee** + **Your added priority fee.** {% endhint %} ### Copy Bribe (SOL) When this option is on, the bot uses the bribe (validator tip) paid by the original wallet plus the extra amount you entered in the *Bribe* field. {% hint style="success" %} **Final bribe** = **Original wallet’s bribe** + **Your added bribe.** {% endhint %} {% hint style="warning" %} Note: Copy Bribe is available only in Anti-MEV and Max Speed execution modes. {% endhint %} ### Gas Delta (ETH) Gas delta will act as the maximum priority gwei for ETH Type-2 transactions. Essentially, the bot will automatically adjust to the current average gas value and then add the chosen Gas Delta on top of it. Example: * Average gas usage is 10 gwei * If you set Gas Delta to 3 gwei, the gas price for your transaction will now be 10 (base) + 3 (priority) gwei. Higher deltas will result in faster transaction speeds at the cost of higher gas fees. ### Priority Fee (SOL) A priority fee is a extra amount of SOL you add to the normal network fee so Solana validators pick your transaction first. Example: * Normal fee: 0.02 SOL * You add Priority Fee: +0.01 SOL * Total cost: 0.03 SOL Higher priority fees speed up confirmation but cost more. ### Bribe (SOL) A bribe is an extra tip (in lamports) you attach to a Solana transaction so validators give it the best possible position in the block, helping you avoid front-running. {% hint style="warning" %} **Note: Bribe is available only in Anti-MEV and Max Speed execution modes.** {% endhint %} Example: * Normal fee: 0.02 SOL * Priority Fee: +0.01 SOL * Bribe: +0.05 SOL * Total cost: 0.08 SOL Higher bribes improve ordering and reliability but increase cost. ### Slippage Slippage is the difference between the expected price of a trade and the actual execution price, expressed in both absolute values and percentages. Slippage can be expressed as a percentage of the expected price, indicating how much the price changed at the moment of trade execution compared to what you planned. Example: Expected price for buying a token: $100. Actual purchase price due to slippage: $120. You overpaid 20% due to slippage. Min/Max values: from 0 to 99%. **Recommended values:** * If this is a low-liquidity new token and you want to ensure its purchase in the first minutes after trading starts, set Slippage to 90%. * If you are following a trader who is trading medium to high liquidity coins and the purchase cost is extremely important to you, limit Slippage to 20%. ### Execution mode Execution mode defines how transactions are sent to the network, balancing speed, cost, and MEV protection. #### Solana * **Standard** *(slow, cheap) -* The cheapest option. Transactions are sent via the default route with low priority. No bribe required and no MEV protection. * **Anti-MEV** *(fast, expensive, safe) -* The safest option. Transactions are routed through MEV-protected paths to reduce frontrunning and sandwich attacks. Faster than Standard, but more expensive. Minimum bribe: 0.001 SOL. * **Max Speed** *(fast, cheap) -* The fastest option. Transactions are delivered through multiple parallel routes to maximize speed and the chance of block inclusion. This mode prioritizes speed and cost efficiency. MEV protection may apply in some cases, but it is not guaranteed. Minimum bribe: 0.0002 SOL. #### Ethereum * **Standard** *(fast, cheap) -* The cheapest option. Transactions are sent normally and are slightly faster than Anti-MEV. * **Anti-MEV** *(slower, cheap, safe) -* The safest option. Transactions are sent using MEV-protected routes to reduce the risk of frontrunning and sandwich attacks. Slightly slower than Standard. #### How to choose * Use Standard for low-cost, non-critical actions. * Use Anti-MEV when protection from MEV is more important than cost. * Use Max Speed on Solana when execution speed and block inclusion matter most. ### Buy token once If this setting is enabled, the bot will only be able to purchase any token once during its operation. ### Max active buys per token Sets a cap on the number of open buy entries for the same token across all trades on this bot. Applies to all buys—copied, manual, and auto. When the cap is reached, any new buy is skipped until one entry is sold/closed. Leave blank for no limit. **Example:** Set to 3. You already have three open buys in TOKEN (across two trades). A new buy signal arrives (copied/manual/auto) → the bot skips it until one of the three entries closes. ### Platforms (SOL) Platform — choose the decentralized exchanges (DEXes) on which the bot is allowed to trade. ### Dupe buy amount Specify the Minimum and Maximum amounts for subsequent purchases in the token's native currency. {% hint style="info" %} The bot will buy the same amount of currency as the original wallet, but no less than the Min and Max values you have set. {% endhint %} ### Skip new trade Checks the leader’s current USD balance of the token whenever a new entry appears. If it’s above your threshold, the bot skips opening a new trade. Leave blank to disable. Does not affect add-on buys inside an existing trade. **Example:** Threshold $5,000 → the leader buys TOKEN while already holding $6,200 of TOKEN → skipped (no new trade). Later their balance drops to $2,800; on the next fresh entry your bot may open a new trade (subject to your Buy limits). ### Max dupe buy times This is the maximum number of additional purchases. If you set Max dupe buy times to 2, the bot will be able to make a total of 3 purchases of the token: the first purchase and 2 additional purchases. ### Max Position per Trade #### Max Position per Trade Hard ceiling on how much the bot may hold inside one trade (first buy + any re-buys). #### Min Add Buy Minimum *remaining gap* that must still be available **under the Max ceiling**. If the free gap is **smaller** than this value, the bot skips the next buy. If the gap is **bigger or equal**, the bot is allowed to fill it **even with a buy that is smaller than your regular Min Buy Amount**. {% hint style="danger" %} **Min / Max value (Min Add Buy)** * Minimum: 0.00005 SOL, 0.000002 ETH * Maximum: no upper limit {% endhint %} {% hint style="success" %} **Priority rule:**\ Min Add Buy overrides Min Buy Amount.\ • Remaining gap ≥ Min Add Buy → the bot may buy that gap (even if it is below Min Buy Amount).\ • Remaining gap < Min Add Buy → order skipped. {% endhint %} **Example:** Settings * Max Position = $500 * Min Buy Amount = $50 * Min Add Buy = $5 | Situation | Remaining gap to the cap | Action | | -------------------------------------- | ------------------------ | --------------------------------------------------------------------------- | | Position = $440 → signal to buy $100 | $60 | Bot buys $60 (trimmed). $60 ≥ Min Buy Amount so normal trim. | | Position = $492 → signal to buy $100 | $8 | Bot buys **$8** even though $8 < Min Buy Amount, because gap ≥ Min Add Buy. | | Position = $499.9 → signal to buy $100 | $0.1 | **Skipped** – gap ($0.1) < Min Add Buy ($5). | **Result:** the position never exceeds $500, and the bot ignores any order if the leftover room is smaller than Min Add Buy. ### Retry Slippage (SOL) Retry Slippage is the maximum price deviation allowed when the bot retries opening a trade. Do not confuse it with regular [Slippage](https://docs.definest.ai/copy-trading-bot/bot-settings#slippage). ### Fee reserve **Fee reserve (native only)**\ Keep a small amount of the network’s native coin (SOL, ETH) untouched so you can always pay fees. Works only when trading in the native coin. Leave empty to disable. **Min native to keep (SOL/ETH)**\ Minimum native balance to preserve. If a buy would push your native balance below this floor, the bot trims the order; if even a minimal spend would breach it, the buy is skipped. **Min buy amount (above reserve) (SOL/ETH)**\ A buy executes only if the free native balance above the reserve is at least this amount; otherwise the buy is skipped. **Example (Solana):** * Wallet balance: 1.00 SOL * Reserve (Min native to keep): 0.30 SOL * Min buy amount (above reserve): 0.05 SOL * Requested buy: 0.80 SOL * Trim calculation: free above reserve = 1.00 − 0.30 = 0.70 SOL → order trimmed to 0.70 SOL * Check: 0.70 SOL ≥ 0.05 SOL → buy executes * Edge case: if free above reserve were 0.03 SOL, the buy would be skipped ### Market cap Market cap = price × total supply of a token. Use Min / Max to include only wallets that trade tokens whose market cap falls within your range. This helps focus on micro-caps, mid-caps, or larger, more established tokens. If a token’s market cap can’t be read, the If unknown option lets you either ignore this filter or skip that token. **Example** * Set Min = $5,000,000, Max = $50,000,000. * The finder will surface wallets whose recent trades involve tokens between $5M–$50M market cap. * Tokens outside the range are excluded. If If unknown = Skip token, trades with missing market-cap data are also excluded. ### Liquidity Liquidity of a coin refers to the ability of the cryptocurrency to be bought or sold quickly on the market without significantly affecting its price. A coin with liquidity of $10 million has a more stable price and allows for larger trades without substantial impact on its price, unlike a coin with liquidity of $100,000. The lower the liquidity, the higher the slippage, and vice versa. ### Token Age This is the lifespan of the coin at the moment of purchase. By limiting the minimum and maximum lifetime of a coin, you can choose which coins to buy. If you want to purchase only recently launched coins, set Max CoinLifetime to 120 minutes (2 hours) or 1440 minutes (24 hours). ### Max Tax This is the maximum allowable commission for buying and selling the coin. In many new coins, the commissions can reach up to 35% in the first few minutes. However, if the coin takes off, these fees will be offset since you bought the coin earlier and at a better price. ## Auto buy
Automatically places a buy when a configured trigger is met. * The Auto buy block appears when Copy trade is ON. * It’s OFF by default; settings inside are locked until you toggle it ON (same behavior as Auto sell). * Auto buy can work even if Copy buy is OFF—your Buy settings still apply. ### After Original Buy Rules here anchor to the original wallet’s executed price and track the market for a chosen Time window. * Each rule can fire once per original buy and uses its Buy percentage for size. * You can add multiple rules; they evaluate independently. \--- * Price change — percent from the original wallet’s *execution price*. Use −X% for dips (buy the drop) or +X% for breakouts (buy the rise). * Time window — how long that price move must occur (min / h / d). * Buy percentage — order size = Buy percentage × your base Buy amount (range 1–1000%). ### Price Move #### Trigger Buy if price changes by ±X% from the original price within the Time window (min / h / d). Use −X% for dips (buy the drop) or +X% for rises (buy the breakout).
#### Example * Price change: −15%, Time window: 60 min, Buy percentage: 100%. * Flow: original buys → price hits −15% within 60 min → one auto-buy executes immediately
### Price Move or Range An auto-buy rule that triggers on either of two conditions within the same time window: * Price Move: price reaches ±X% from the original wallet’s executed buy price. * Price Range: by the end of the window, price is between *Price min* and *Price max* (both in % from the original buy). Each rule fires once per original buy and sizes the order by Buy percentage. It respects your Buy limits (amounts, caps, budgets, dupe rules, slippage, etc.). #### **How it works (fields)** * Price change (±X%) — threshold for the Price Move condition. * Time window — how long the rule watches the move/range (min / h / d). * Buy percentage — order size = % × your base Buy amount. * Price min / Price max — bounds for the Range check at window end (inclusive). #### Examples Settings: * *Price change = −15%* * *Time window = 60 min* * *Price min = −5%*, *Price max = +5%* * *Buy percentage = 100%*.
1. **Triggers by Price Move (dip hit −15%)** * Price falls to −15% anytime within 60 minutes → auto-buy executes immediately.
2. **Triggers by Price Range (ends inside band)** * Price never hits −15% during the window, but at 60 minutes it sits between −5% and +5% → auto-buy executes at window end.
3. **No auto-buy** * Price never hits −15%, and at 60 minutes it’s outside −5%…+5% → rule does not fire.
Notes * The two conditions are joined by OR: the first to qualify wins. * One auto-buy per original buy event. Further behavior depends on “Only while original trade is open” and “Reset on new original buy (same trade)”. ### Only while original trade is open If ON, the auto-buy triggers only while the original wallet still holds the token during the window. If the original closes the trade, the trigger is cancelled. Turn OFF to allow triggering even after the original closes. ### Reset on new original buy (same trade) If ON, whenever the original adds another buy in the same trade, any active window from earlier buys is cancelled and a fresh window starts from the latest buy. Turn OFF to keep earlier windows active (multiple auto-buys may fire). **Flow:** Base Buy amount = $100. The original buys at $1.00. Price drops to $0.85 within 30 minutes → the bot places one auto-buy for $250 (250% of base), respecting your Buy limits/reserve/caps. If the original closes before −15% is reached, the trigger is canceled. If the original buys again in the same trade, the 30-minute window resets from that new buy and the previous window is discarded (because Reset… ON). ### Notes * Percent is measured from the original’s executed price, not from your average. * All protection from Buy applies to Auto buy (amount min/max, caps, dupe buy limits, budgets). * Each auto-buy appears in your trade history as a separate buy made by your bot. ## Sell ### Copy sell This is the main setting that enables copying sales from the original wallet. If this setting is turned off, the bot will not sell anything. {% hint style="success" %} Enable this setting for the bot to be able to sell tokens while following the original wallet. {% endhint %} ### Retry times In case of an error during the sale, the bot will attempt to sell as many times as specified here. Recommended value for Ethereum: 20. Recommended value for Solana: 2. Max: 5. ### Copy Gas (ETH) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#copy-gas-eth). ### Copy Priority Fee (SOL) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#copy-priority-fee-sol). ### Copy Bribe (SOL) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#copy-bribe-sol). ### Gas Delta (ETH) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#gas-delta-eth). ### Priority Fee (SOL) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#copy-priority-fee-sol). ### Bribe (SOL) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#copy-bribe-sol). ### Slippage The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#slippage). ### Anti-MEV The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#anti-mev). ### Round up to 100% If the original wallet sold 95% of the purchased tokens, your bot will also sell 95% by default when Copy Sell is enabled. This setting allows you to round sales up to 100%. Simply specify the percentage at which to round up to 100% (to sell the entire position). ### Scheduled sell retries Runs only after the bot’s normal sell retries fail. Applies to all non-manual sells; manual sells are excluded. {% hint style="info" %} **Retry times: 1–10 (leave blank to disable). Retry every: 1–1800 sec (default 30 sec).** {% endhint %} Each scheduled retry fires after the set interval (then repeats on the same interval), uses the same sell logic and standard retries, and respects your limits (balance, fee reserve, slippage, etc.). Retries stop on success, when the position is closed/zero, or when the retry limit is reached. **Example:** * Settings: Retry times = 3; Retry every = 300 sec (5 min) * Attempts: T+5m, T+10m, T+15m * Outcome: if any attempt succeeds, later attempts are canceled ## Approve (ETH) Approving a token is the process in the blockchain where you grant permission to a smart contract or decentralized application (dApp) to use a certain amount of your tokens. In simpler terms, you allow the application access to your tokens for a specific purpose. ### Auto approve {% hint style="success" %} Make sure to enable this setting for the bot to be able to sell your tokens. {% endhint %} ### Retry times In case of an error while executing the Approve, the bot will attempt to execute it as many times as specified here. Recommended value: 4. ### Gas Delta (gwei) The concept is the same as [mentioned earlier](https://docs.definest.ai/copy-trading-bot/bot-settings#gas-delta-gwei). Recommended values: 1 or 2 GWEI. ## Auto sell This setting allows the bot to automatically sell your tokens based on Stop-loss, Take-profit, and Time-fix. {% hint style="success" %} Enable this setting for sales based on Stop-loss, Take-profit, and Time-fix. {% endhint %} ## Take-profit Take-Profit allows you to automatically secure profits when an asset’s price reaches a specified level. This helps prevent losing your gains due to sudden market changes and reduces the emotional impact on your trading decisions. Example: You bought Bitcoin at $40,000 and set a Take-Profit at a 10% profit. When the price increases by 10% to $44,000, your position will automatically close, locking in a 10% profit. In this example: * Price Change - This is the price of the token at which the order to close the position is triggered. * Volume - This is the percentage of tokens that will be sold when the Price Change is reached.
### Take-Profit Ladder A Take-Profit Ladder helps secure profits in parts, reducing the risk of missing out on gains from further price movements. Instead of closing the entire position at one profit level, the trader closes it partially at each step of the ladder, allowing for gradual profit-taking while keeping part of the position open for potential further growth. You bought Bitcoin at $40,000 and set three Take-Profit levels with gains: * First Take-Profit at +5% profit ($42,000) — closes 33% of the position. * Second Take-Profit at +10% profit ($44,000) — closes another 33% of the position. * Third Take-Profit at +15% profit ($46,000) — closes the remaining 34% of the position. When the price hits $42,000, the first part of the position closes with a 5% profit, at $44,000 the second part closes with a 10% profit, and at $46,000 the remaining part closes with a 15% profit.
## Stop-loss A stop-loss helps limit your losses by automatically closing a trade if the asset’s price moves against you. This protects your capital from significant losses and helps manage risk without needing to constantly monitor the market. Example: You bought Bitcoin at $50,000 and set a stop-loss at a -10% loss. If the price decreases by -10% to $45,000, your position will automatically close, limiting the loss to 10%. * Stop price - This is the price of the token at which the order to close the position is triggered. * Volume - This is the percentage of tokens that will be sold when the Stop price is reached.
### Conditional Stop-loss **Conditional Stop-Loss** is a type of order that automatically closes your position when certain market conditions are met. Unlike a regular stop-loss, which is activated immediately upon reaching a specified price, a conditional stop-loss is set at the Trigger price, and from that moment, it functions like a regular stop-loss, activating when the Stop price is reached. **Conditional Stop-Loss consists of:** * **Trigger Price** - This is the price level at which the Conditional Stop-Loss is activated and becomes a valid order. * **Stop Price** - This is the price of the token at which the order to close the position is triggered. The Stop price is calculated from the Trigger price. * **Volume** - This is the percentage of tokens that will be sold when the Stop price is reached. **Example:** If the token price increases by 100% (doubles), a Stop-Loss will be set for a price change of -15% with the sale of all tokens. This type of stop-loss allows us to secure profits in case the token rises first and then begins to fall.
### **Stop-loss** Ladder The stop-loss ladder allows you to distribute risk across multiple levels, reducing the likelihood of significant losses in the event of a sharp market movement against your position. Instead of setting a single stop-loss, you place several, which provides flexibility and better protection for your capital. In the case of a Conditional Stop-Loss, the ladder can help increase your profits. **Example:** Three stop-losses are set: * The first stop-loss limits our losses if the price drops by 15% immediately after purchase. In this case, we will sell 100% of the position. * The second stop-loss activates only when the price increases by 100% (doubles). If the price then drops by 15%, the bot will sell 100% of the tokens, securing an 85% profit. * The third stop-loss is similar to the second but activates when the price reaches 200% (triples). If the price then drops by 15%, the bot will sell 100% of the tokens, securing a profit of 185%. The number of stop-losses is unlimited. You can choose to sell not 100% of the tokens, but 1%, 5%, 10%, 30%, 50%, 85%, etc. It all depends on your trading strategy.
### Timeout When the Stop Loss timeout option is enabled, the system will delay the execution of the trade for the specified amount of time (in seconds). This is useful for preventing accidental stop-loss triggers due to temporary market fluctuations. If the price reaches the stop-loss level but quickly rebounds, the timeout allows the system to wait for confirmation of a sustained price movement before executing the order.
When the price drops to or below the stop-loss level you have set, the system will wait for the specified time. If, after this time has elapsed, the price is above the stop-loss price (as shown in the image below), the stop-loss order will not be executed, and the trade will remain open.
If, after the timeout expires, the price is still at or below the stop-loss price (as shown in the image below), the stop-loss order will be executed, and the trade will be closed.
The decision to execute the stop-loss order will be made only after the timeout has elapsed. ### Activate stop-losses after N buys This setting delays the placement of stop-losses until the specified number of purchases has been made. If you set it to 2 buys, the stop-losses will only be placed after the bot has made 2 purchases in a single trade.
This can be useful when following frequently trading traders who may average down (buy more of the same token) multiple times during a token’s decline. Without this setting, your stop-loss may trigger too quickly, not allowing for averaging down. ### Don't dupe buy in this trade after the stop-loss When this setting is enabled, any further purchases of the token will be prohibited after any stop-loss is triggered in this trade.
This can be useful when following frequently trading traders who may average down (buy more of the same token) multiple times during a token’s decline. Some traders may average down up to 30 times, investing 100% of their capital into one coin. ## Time-fix Time-fix is a time-based sell trigger (alongside Stop-Loss and Take-Profit). Instead of reacting to price immediately, it waits for a set period and then sells a portion of the position. **How it works** * When the Time Delta elapses (counted from a chosen Time since anchor), the bot places a sell for Volume% of the current token balance. * Each rule fires once; multiple rules (a “ladder”) sell from the remaining balance as they trigger. * Uses the same sell logic as normal sells (limits, slippage, min amounts, fee reserve, scheduled sell retries, etc.). ### Standard Time-fix * Time since — the anchor point to start counting from: * Coin’s launch: since the token’s first trades on chain. * First Buy: since your first buy in this trade. * Last Buy: since your most recent buy in this trade. * Time Delta (min) — how long to wait. * Volume (%) — how much of the position to sell when the timer ends. Example *Time since:* Last Buy • *Time Delta:* 600 min • *Volume:* 25% → After 10 hours from your last buy, sell 25% of the remaining tokens (regardless of price).
You can also use a Time-Fix ladder in accordance with your trading strategy. ### Price Range Time-fix Adds a price condition at the end of the timer: sell only if the price is inside a band around the anchor price. **Extra fields** * Price min (%), Price max (%) — acceptable change vs the anchor price (the price at the chosen *Time since*). Bounds are inclusive. **When it fires** * At Time Delta, if Price min ≤ percent change ≤ Price max, sell Volume%. * If the price is outside the band, the rule does not sell.
**Example 1** * *Time since:* Last Buy * *Time Delta:* 60 min * *Price min/max:* −5% … +5% * *Volume:* 100% → After 60 min, sell 100% only if price is within −5% to +5% of your last-buy price. **Example 2** * Same settings, but price is +9% at 60 min → No sell (outside the band). ## Bad Trader Protection Bad Trader Protection is a safety net that monitors your bot’s performance and—if any user-defined loss threshold is hit—automatically pauses copying or liquidates positions. Its goal is to stop you from following a wallet that has suddenly turned unprofitable. ### **Condition types** | Indicator (dropdown) | What the trigger checks | Value range | | -------------------- | -------------------------------------------------------------------- | ----------- | | **PnL Total** | Total PnL falls below **X USD** within **T** | any USD | | **PnL Realized** | Profit & loss from closed trades only | any USD | | **ROI Total** | Overall return (open + closed trades) drops below **X** % in **T** | –100 % … ∞ | | **ROI Realized** | Return on **closed** trades only | –100 % … ∞ | | **WinRate Total** | Share of winning trades (open + closed) falls below **X %** in **T** | 0 % – 100 % | | **WinRate Realized** | Share of winning **closed** trades | 0 % – 100 % | | **Loss streak** | At least **N** trades in a row, each with PnL below **X USD** | N ≥ 1 | {% hint style="warning" %} **You can mix and match as many conditions as you like.** **Protection triggers if any one is met.** {% endhint %} ### **Actions when triggered** | Action | Result | | ----------------------- | ----------------------------- | | **Stop copy/auto buys** | Ignore new buy signals | | **Stop copy sells** | Ignore new sell signals | | **Sell all assets** | Liquidate every open position |
**Example** * *PnL Total over 24 h drops below –150 USD* * *ROI Total over 3 h drops below –10 %* * *Loss streak: at least 5 trades, PnL per trade below –20 USD* * *Actions:* Stop copying buys and Sell all assets How it works 1. The bot has lost $160 in the last 24 h. That meets the first condition. 2. Protection triggers → the bot stops copying any new buys and instantly liquidates all current positions. # Bot groups You can create any number of wallets/bots to follow one or multiple original wallets. These bots can be grouped into one or several groups, making it easier to track overall profitability metrics.
For example, you can create 3 groups of wallets/bots: * **Traders** - for following frequently trading wallets that earn 5%-40% profit on each trade. * **Snipers** - for following wallets that invest only in newly launched tokens with the goal of achieving 10,000% returns. * **Investors** - long-term traders, where trades can last for months. Each group can contain any number of wallets, for example, 3 wallets each. As a result, you will be able to see the profitability of each group (strategy) and draw conclusions. ### How to Create a New Group of Bots/Wallets 1. Click Add bots group + 2. Enter the name of the group. 3. Done! ### How to Move Wallets Between Bot Groups To the left of the wallet icon, there is an icon with 6 dots. Grab the wallet by this icon and drag it to the desired group. All group metrics will be recalculated immediately.
### How to Rename a Bot Group To the right of each group, there is an icon of sliders for settings. Click on it and enter the current name of the group.
# Group Settings ## Group Name Display name for this bot group. You can rename it anytime—this won’t affect the bots or their settings. ## Buy ### Max active buys per token Sets a group-wide cap on the number of open buy entries for the same token across all bots in this group. Applies to all buys (copied, manual, auto). When the cap is reached, any new buy for that token (from any bot in the group) is skipped until one entry closes. If both group and bot limits exist, the stricter one applies. Leave blank for no group limit. **Example:** Set to 5. Across three bots you already have 5 open buys in TOKEN. A new buy signal appears on any bot → it’s skipped until one of the five entries closes. # Bot page ## **Overview of the Bot Page** The bot page consists of: * A block with information about your wallet. * A block with information about the original wallet (the one you are following). * Main control buttons. * **Open Trades** - a block with open trades (your wallet). * **Original Wallet Open Trades** - trades that are open in the original wallet but not open in yours. * **Closed Trades** - completed trades.
## **Wallet Information** * **Trader test 1** - The name of your wallet/bot * **0x70c4...08f0** - The address of your wallet (next to it is a button to copy the full address). * Next is a link to Zerion, where you can view all transactions and balances. * To the right is a link to with information about your wallet. * **Balance** - The total balance of your wallet, including all coins. * Balance — Total wallet value in USD (all assets on this chain). * USDC — The USDC balance in your wallet. * SOL — The SOL balance in your wallet. * Refresh icon — Refreshes all balances (Balance, USDC, SOL). * Actions: * Add Funds — Deposit assets to this wallet. * Withdraw — Send assets out of this wallet. * Swap — Quick exchange between SOL ⇄ USDC. * Cleanup — Close empty token accounts and reclaim SOL rent.
## Swap
Exchange between the native coin and the stable on the current network (Solana: SOL ⇄ USDC; Ethereum: ETH ⇄ USDT). **Fields & controls** * From — amount you sell. Token selector on the right; quick chips 25% / 50% / Max use your available balance. USD estimate is shown below. * To — amount you receive. Auto-calculated from the current rate (read-only). * ↕ Reverse — swap the sides (From/To) and update the CTA. **Action** * Swap A → B — executes the trade. The button is disabled until the amount is valid and you have enough balance. **Price & Fee** * Price — execution quote, e.g. 1 SOL ≈ 221.74 USDC (may update with the market). * Fee — total estimated fee. * Solana: Definest 0.10% + pool fee \~0.04% (varies by pool) + priority fee 0.0001 SOL (paid in SOL). * Ethereum: Definest 0.10% + network gas in ETH. *Pool/liquidity fee may apply and will be shown once available.* * Final fee may differ slightly at execution; slippage is not a fee. **Notes** * You must have enough native coin for fees; otherwise the swap won’t start. * After success you’ll see a confirmation (amounts swapped and effective price); you can start a New swap or Close. ### Auto swap {% hint style="info" %} While Auto swap is on, manual Swap is hidden to avoid conflicts. {% endhint %} Automatically keeps your native-coin balance near a Target by swapping with the stablecoin. * Turn Auto swap On (manual Swap is hidden to avoid conflicts). * Choose SOL balance units (USD or SOL). * Set thresholds: Buy if balance < X (tops up to Target), Target balance, Sell if balance > Y (sells down to Target). **Example:** * Units: USD. Buy if < 100 → Target 200 → Sell if > 300 * If your SOL balance is $80, the bot buys SOL from USDC up to $200 * If your SOL balance is $320, the bot sells SOL to USDC down to $200
{% hint style="info" %} *When Auto swap is on, the Swap button shows a green “A” badge — Auto swap is active* {% endhint %}
**Price & Fee** * Price — execution quote, e.g. 1 SOL ≈ 221.74 USDC (may update with the market). * Fee — total estimated fee. * Solana: Definest 0.10% + pool fee \~0.04% (varies by pool) + priority fee 0.0001 SOL (paid in SOL). * Ethereum: Definest 0.10% + network gas in ETH. *Pool/liquidity fee may apply and will be shown once available.* * Final fee may differ slightly at execution; slippage is not a fee. ## **Main Control Buttons** * **Settings** — open full bot settings. * USDC / SOL — select the quote currency the bot trades with on Solana (on Ethereum this will be USDT / ETH). It also defines the currency for limits in *Buy* and *Advanced*. * **Copy Trade** — master switch for mirroring the original wallet. When off, the bot does not track the wallet’s buys/sells and the Copy buy and Copy sell switches are ignored (no copying happens). When on, copying follows your Copy buy / Copy sell settings and limits. * Copy buy — copy the wallet’s buys (subject to your limits). * Copy sell — copy the wallet’s sells. If off, positions are held until your own rules or manual actions. * Sell all assets — market-sell all tokens currently held by the bot and close open positions (doesn’t touch your base balances like SOL/USDC). * Blacklist — add tokens you don’t want the bot to buy again. * Buy any token — open the quick buy dialog. **All Settings Enabled:**
**All Settings Disabled:**
[**Bad Trader Protection**](https://docs.definest.ai/copy-trading-bot/bot-settings#bad-traders-defense) **activated:**
## Open trades Here, the open trades of your wallet are displayed. While a trade is open, the bot continuously monitors and updates its data.
**Available Actions in an Open Trade:**
* **Buy ON / OFF** — Enable/disable copying additional buys for this trade. Manual buys use Buy on amount. * **Sell ON / OFF** — Enable/disable copying sells/exits for this trade. When OFF, the position is held until your rules or a manual action. * **Blacklist ON / OFF** — Add/remove the token from the bot’s blacklist. Prevents future buys of this token; does not close the current position. * **G SL ON / OFF** — Global Stop-Loss, applies to all trades. * **G TP ON / OFF** — Global Take-Profit, applies to all trades. * **G TF ON / OFF** — Global Time-Fix/expiry, applies to all trades. * **Buy on amount** — One-off manual buy for a specified amount (in the selected Trade with currency). * **Sell %** — One-off manual sell of the chosen percentage of the current position. * **☢️ Sell** — Emergency sell of 100% at market (“panic sell”). * **+ SL/TP** — Add local Stop-Loss/Take-Profit for this trade only (overrides global values). * **Close** — Mark the trade closed without selling; PnL/ROI remain visible and copying stops. * **SCAM** — Mark as scam; treat any remaining tokens as lost and lock in the loss in metrics. * **Share** — Create a shareable image (PnL, ROI, time in trade, X-multiple, token name); you can also copy a link. ## **Original Wallet Open Trades** This status includes trades that: * Were opened in the original wallet but have not been opened in yours for the following reasons: * Insufficient funds in the balance. * The coin does not meet the bot's settings (fees, liquidity, coin lifetime, etc.). * You closed the trade, but the original wallet has not yet done so.
**Available Action:** * **Blacklist ON / OFF** — Add/remove this token from the bot’s blacklist. Prevents future buys of this token; does not auto-close the current position. * **Retry buy anyway** — Re-run a buy right now, overriding soft filters (e.g., liquidity/age/tax checks or risk guards). Hard limits still apply (balance, Copy Trade OFF, token blacklisted, etc.). *Use with caution.* * **Close trade** — Mark the followed wallet’s trade as closed so the bot won’t attach future buys of this token to this trade. If copying is enabled, the next buy will open a new trade. No tokens are sold; existing PnL/ROI remain visible. * **Buy on amount** — One-off manual buy for a specified amount (in the current Trade with currency). Counts toward your position limits.
## **Closed Trades** This status includes fully completed trades for both you and the original wallet.
**Available Action:** * **Buy on Amount** - Manual purchase of this token for the specified amount. * **Buy on amount** — One-off manual buy for a specified amount (in the current Trade with currency). Counts toward your position limits. * **Share** — Create a shareable image (PnL, ROI, time in trade, X-multiple, token name); you can also copy a link. # Error Messages ## insufficient funds {% hint style="danger" %} Fail to buy PRIV token for 0.125 ETH \~$291.49 by API buy command. Attempt 3. Fail to send transaction, type=\, message=ValueError({'code': -32000, 'message': 'insufficient funds for gas \* price + value: balance 141947753571836880, tx cost 149184184735500000, overshot 7236431163663120'}) {% endhint %} The error message indicates that your wallet does not have enough funds to cover the transaction cost, which includes both the amount to buy the token (0.125 ETH) and the gas fees. Solution: Verify that your wallet has sufficient funds not only to buy the token but also to cover gas fees. Add more ETH to your wallet to cover both the purchase cost and gas fees. ## Smart Contract Issues {% hint style="danger" %} Fail to sell 100% of FUXI token for \~$41.91 by time fix.. Attempt 4. Fail to build transaction, type=\, message=execution reverted: TransferHelper: TRANSFER\_FROM\_FAILED {% endhint %} Smart Contract Issues: The FUXI token’s smart contract or the DEX may have restrictions or bugs preventing the transfer. Check Contract: Review the FUXI and DEX smart contract documentation to ensure there are no additional requirements or restrictions. ## Insufficient Liquidity or low slippage {% hint style="danger" %} Fail to sell 100% of Au token for \~$92.41 by time fix.. Attempt 4. Fail to build transaction, type=\, message=execution reverted: UniswapV2: INSUFFICIENT\_OUTPUT\_AMOUNT {% endhint %} ### Insufficient Liquidity The liquidity pool might not have enough token volume to execute the trade. Check Liquidity: Ensure that the liquidity pool for Au and ETH (or another pair) has sufficient volume. ### Low slippage The message from UniswapV2 indicates that the amount of received funds is less than the minimum expected. This could be due to high price volatility or slippage settings. Increase Allowed Slippage: Adjust the bot’s settings to allow a higher slippage tolerance when executing the trade.
# Getting Started with Definest API ### How Definest API works Definest actually has two different APIs, and you’ll need a separate key for each one. ### 1. Analytics API This key unlocks our on-chain analytics engine. With it you can pull deep wallet data, build custom filters, and hunt for profitable addresses. Analytics access starts on the [**Premium plan**](https://definest.ai/plan) (and on any higher plan we add later). ### 2. Trading Plus API This key lets you do the hands-on stuff—place buy/sell orders, run copy-trading, and manage your trading bots or bot groups. Because it can move real money, creating or regenerating this key requires a quick two-step check through email *and* Telegram. Trading Plus works on every plan, including Free; only the request limits change with each tier. *** We’re steadily adding new endpoints to both APIs. Want the latest updates? Keep an eye on our [Telegram channel ](https://t.me/definest_ai)and our [X (Twitter)](https://x.com/definest_ai) feed. # Authentication The Analytics API uses API key authentication through the `X-API-KEY` header. This authentication method provides secure access to analytics endpoints for users with paid subscription plans. ## Obtaining an API Key * **Have a paid subscription** - API access is not available for free plan users * Get or create your Analytics API key on [Definest API page](https://definest.ai/api) ## API Key usage Include your API key in the header for all Analytics API requests: `X-API-KEY` ``` curl -H "X-API-KEY: your_api_key_here" ``` ## Rate Limits The limit is currently set at **60 requests per minute** and **5k requests per day**. If you reach the limit, request will return a 429 status code with an error for every request beyond the limit before it will be reset. # Wallet analytics The wallets endpoint allows you to access various information about wallets and their trades # Authentication The Analytics API uses API key authentication through the `X-API-KEY` header. This authentication method provides secure access to analytics endpoints for users with paid subscription plans. ## Obtaining an API Key * **Have a paid subscription** - API access is not available for free plan users * Get or create your Analytics API key on [Definest API page](https://definest.ai/api) ## API Key usage Include your API key in the header for all Analytics API requests: `X-API-KEY` ``` curl -H "X-API-KEY: your_api_key_here" ``` ## Rate Limits The limit is currently set at **60 requests per minute** and **5k requests per day**. If you reach the limit, request will return a 429 status code with an error for every request beyond the limit before it will be reset. # Wallets list Request cost: 5 credits ## POST /wallets > Returns a list of wallets with filtering, sorting, and pagination capabilities ```json {"openapi":"3.1.0","info":{"title":"Analytics API","version":"1.0.4"},"tags":[{"name":"wallet","description":"Wallet"}],"servers":[{"url":"https://definest.ai/api/analytics/v1","description":"Production server"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"schemas":{"BlockchainNetwork":{"type":"string","enum":["eth","sol"],"description":"Supported blockchain networks"},"WalletListOrderSchema":{"type":"object","properties":{"indicator":{"$ref":"#/components/schemas/WalletListIndicatorKey"},"period":{"$ref":"#/components/schemas/Period"},"order":{"type":"string","description":"Sort direction","enum":["asc","desc","asc_following","desc_following"]}},"required":["indicator","period","order"]},"WalletListIndicatorKey":{"type":"string","description":"Indicator key","enum":["pnl_realized","pnl_unrealized","pnl_total","median_pnl_realized","roi_realized","roi_unrealized","roi_total","median_roi_realized","roi_high","roi_low","win_rate_realized","win_rate_unrealized","win_rate_total","trade_duration","trades_count","sharp_rate","scam_trades","token_age","first_buy_amount","buy_amount","capital_required","max_drawdown","liquidity","market_cap","closed_trades","top_deal_percent_realized","top_deal_percent_total","profit_linearity"]},"Period":{"type":"string","description":"Time period","enum":["12h","24h","2d","3d","7d","10d","14d","20d","1m","2m","3m","6m","1y","2y"]},"WalletApiFilterOptionsSchema":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/WalletListFilterOptionKey"},"period":{"type":["string","null"],"description":"Required for indicators type. Optional for `trade_start_time` and `trade_start_window`.","allOf":[{"$ref":"#/components/schemas/Period"}]},"following":{"type":"boolean","default":false,"description":"Apply filter to followed values. Optional for `trade_start_time` and `trade_start_window`."},"min":{"type":["number","null"],"description":"Minimum value. For `trade_start_time` use timestamp in seconds"},"max":{"type":["number","null"],"description":"Maximum value. For `trade_start_time` use timestamp in seconds"}},"required":["type"]},"WalletListFilterOptionKey":{"description":"Filter key","oneOf":[{"type":"string","enum":["trade_start_time","trade_start_window"]},{"$ref":"#/components/schemas/WalletListIndicatorKey"}]},"WalletListItem":{"type":"object","description":"Wallet information for wallet list","properties":{"address":{"$ref":"#/components/schemas/Wallet/properties/address"},"network":{"$ref":"#/components/schemas/Wallet/properties/network"},"indicators":{"$ref":"#/components/schemas/WalletIndicatorsForPeriod"}},"required":["address","network","indicators"]},"Wallet":{"properties":{"address":{"type":"string","description":"Wallet address"},"network":{"$ref":"#/components/schemas/BlockchainNetwork"}}},"WalletIndicatorsForPeriod":{"type":"object","description":"Object where key is indicator name and value is object with indicator values by period","additionalProperties":{"type":"object","description":"Object where key is period and value is indicator values data","additionalProperties":{"$ref":"#/components/schemas/IndicatorAnyValues"}}},"IndicatorAnyValues":{"type":"object","description":"Indicator values","properties":{"initial":{"type":["number","integer"],"description":"Indicator initial value"},"following":{"type":["number","integer","null"],"description":"Indicator following value"}},"required":["initial","following"]},"PagePagination":{"type":"object","properties":{"current":{"type":"integer","description":"Current page number"},"per_page":{"type":"integer","description":"Number of items per page"},"total_pages":{"type":"integer","description":"Total number of pages"},"total_items":{"type":"integer","description":"Total number of items"}},"required":["current","per_page"]},"ResponseCredits":{"type":"object","description":"Credits data after request","properties":{"spent":{"type":"integer","description":"Credits spent on the request"},"remaining":{"type":"integer","description":"Remaining credits"}},"required":["spent","remaining"]}},"responses":{"400BadRequest":{"description":"Request fail","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}},"401Unauthorized":{"description":"API Key invalid or missing"},"403Forbidden":{"description":"API access forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}}}},"paths":{"/wallets":{"post":{"description":"Returns a list of wallets with filtering, sorting, and pagination capabilities","tags":["wallet"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination"},"networks":{"type":"array","items":{"$ref":"#/components/schemas/BlockchainNetwork"},"minItems":1,"description":"List of specific blockchain networks to return wallets for"},"order":{"$ref":"#/components/schemas/WalletListOrderSchema"},"filters":{"type":"array","items":{"$ref":"#/components/schemas/WalletApiFilterOptionsSchema"},"description":"List of filters to apply"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"wallets":{"type":"array","items":{"$ref":"#/components/schemas/WalletListItem"},"description":"List of wallets"},"page":{"$ref":"#/components/schemas/PagePagination"}},"required":["wallets","page"]},"credits":{"$ref":"#/components/schemas/ResponseCredits"}},"required":["result","credits"]}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"}}}}}} ``` # Wallet indicators Request cost: 1 credits ## GET /wallets/{address}/indicators > Returns wallet indicators data. \ > When the \`from\_time\` or \`to\_time\` fields are specified, \ > data will be recalculated for the given time range and results will be returned without period-based grouping.
```json {"openapi":"3.1.0","info":{"title":"Analytics API","version":"1.0.4"},"tags":[{"name":"wallet","description":"Wallet"}],"servers":[{"url":"https://definest.ai/api/analytics/v1","description":"Production server"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"parameters":{"WalletAddressPathParam":{"name":"address","in":"path","description":"Wallet address","required":true,"schema":{"$ref":"#/components/schemas/Wallet/properties/address"}},"BlockchainNetworkQueryParam":{"name":"network","in":"query","description":"Blockchain network","required":true,"schema":{"$ref":"#/components/schemas/BlockchainNetwork"}},"FromTimeQueryParam":{"name":"from_time","in":"query","description":"Timestamp in seconds. \nMinimum time for the deal's first trade.\nDeals started before this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}},"ToTimeQueryParam":{"name":"to_time","in":"query","description":"Timestamp in seconds. \nMaximum time for deal trades. \nTrades executed after this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}}},"schemas":{"Wallet":{"properties":{"address":{"type":"string","description":"Wallet address"}}},"BlockchainNetwork":{"type":"string","enum":["eth","sol"],"description":"Supported blockchain networks"},"WalletIndicatorsForPeriod":{"type":"object","description":"Object where key is indicator name and value is object with indicator values by period","additionalProperties":{"type":"object","description":"Object where key is period and value is indicator values data","additionalProperties":{"$ref":"#/components/schemas/IndicatorAnyValues"}}},"IndicatorAnyValues":{"type":"object","description":"Indicator values","properties":{"initial":{"type":["number","integer"],"description":"Indicator initial value"},"following":{"type":["number","integer","null"],"description":"Indicator following value"}},"required":["initial","following"]},"WalletIndicatorsForTimeRange":{"type":"object","description":"Object where key is indicator name and value is indicator values data","additionalProperties":{"$ref":"#/components/schemas/IndicatorAnyValues"}},"ResponseCredits":{"type":"object","description":"Credits data after request","properties":{"spent":{"type":"integer","description":"Credits spent on the request"},"remaining":{"type":"integer","description":"Remaining credits"}},"required":["spent","remaining"]}},"responses":{"400BadRequest":{"description":"Request fail","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}},"401Unauthorized":{"description":"API Key invalid or missing"},"403Forbidden":{"description":"API access forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}}}},"paths":{"/wallets/{address}/indicators":{"get":{"description":"Returns wallet indicators data. \nWhen the `from_time` or `to_time` fields are specified, \ndata will be recalculated for the given time range and results will be returned without period-based grouping.\n","tags":["wallet"],"parameters":[{"$ref":"#/components/parameters/WalletAddressPathParam"},{"$ref":"#/components/parameters/BlockchainNetworkQueryParam"},{"$ref":"#/components/parameters/FromTimeQueryParam"},{"$ref":"#/components/parameters/ToTimeQueryParam"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"indicators":{"oneOf":[{"$ref":"#/components/schemas/WalletIndicatorsForPeriod"},{"$ref":"#/components/schemas/WalletIndicatorsForTimeRange"}]}},"required":["indicators"]},"credits":{"$ref":"#/components/schemas/ResponseCredits"}},"required":["result","credits"]}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"}}}}}} ``` # Wallet deals Request cost: 1 credits ## GET /wallets/{address}/deals > Returns wallet deals. \ > When the \`from\_time\` or \`to\_time\` fields are specified, \ > deals will be filtered and recalculated for the given time range.
```json {"openapi":"3.1.0","info":{"title":"Analytics API","version":"1.0.4"},"tags":[{"name":"wallet","description":"Wallet"}],"servers":[{"url":"https://definest.ai/api/analytics/v1","description":"Production server"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"parameters":{"WalletAddressPathParam":{"name":"address","in":"path","description":"Wallet address","required":true,"schema":{"$ref":"#/components/schemas/Wallet/properties/address"}},"BlockchainNetworkQueryParam":{"name":"network","in":"query","description":"Blockchain network","required":true,"schema":{"$ref":"#/components/schemas/BlockchainNetwork"}},"FromTimeQueryParam":{"name":"from_time","in":"query","description":"Timestamp in seconds. \nMinimum time for the deal's first trade.\nDeals started before this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}},"ToTimeQueryParam":{"name":"to_time","in":"query","description":"Timestamp in seconds. \nMaximum time for deal trades. \nTrades executed after this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}}},"schemas":{"Wallet":{"properties":{"address":{"type":"string","description":"Wallet address"},"network":{"$ref":"#/components/schemas/BlockchainNetwork"}}},"BlockchainNetwork":{"type":"string","enum":["eth","sol"],"description":"Supported blockchain networks"},"Deal":{"type":"object","description":"Deal information","properties":{"id":{"type":["integer"],"description":"Deal ID"},"network":{"$ref":"#/components/schemas/Wallet/properties/network"},"token":{"$ref":"#/components/schemas/Token"},"open_time":{"type":"object","description":"Opening time","properties":{"initial":{"type":"integer","description":"Initial opening time. Timestamp in seconds"},"following":{"type":["integer","null"],"description":"Following opening time. Timestamp in seconds"}},"required":["initial","following"]},"last_operation_time":{"type":"object","description":"Last operation time","properties":{"initial":{"type":"integer","description":"Initial last operation time. Timestamp in seconds"},"following":{"type":["integer","null"],"description":"Following last operation time. Timestamp in seconds"}},"required":["initial","following"]},"status":{"type":"object","description":"Deal status values","properties":{"initial":{"$ref":"#/components/schemas/DealStatus"},"following":{"$ref":"#/components/schemas/DealStatus"}},"required":["initial","following"]},"trades_number":{"type":"object","description":"Number of trades in deal","properties":{"initial":{"type":["integer"],"description":"Initial trades number"},"following":{"type":["integer","null"],"description":"Following trades number"}},"required":["initial","following"]},"closed_position":{"type":"object","description":"Close position percent (%)","properties":{"initial":{"type":["integer"],"description":"Initial close position percent"},"following":{"type":["integer","null"],"description":"Following close position percent"}},"required":["initial","following"]},"pnl_realized":{"$ref":"#/components/schemas/IndicatorPnlValues"},"pnl_unrealized":{"$ref":"#/components/schemas/IndicatorPnlValues"},"pnl_total":{"$ref":"#/components/schemas/IndicatorPnlValues"},"roi_realized":{"$ref":"#/components/schemas/IndicatorRoiValues"},"roi_unrealized":{"$ref":"#/components/schemas/IndicatorRoiValues"},"roi_total":{"$ref":"#/components/schemas/IndicatorRoiValues"},"roi_low":{"$ref":"#/components/schemas/IndicatorRoiValues"},"roi_high":{"$ref":"#/components/schemas/IndicatorRoiValues"},"capital_required":{"$ref":"#/components/schemas/IndicatorCapitalRequiredValues"},"pools":{"type":"array","description":"Used pools","items":{"$ref":"#/components/schemas/Pool"}},"trades":{"type":"array","items":{"$ref":"#/components/schemas/Trade"}}},"required":["id","network","token","open_time","last_operation_time","status","trades_number","closed_position","pnl_realized","pnl_unrealized","pnl_total","roi_realized","roi_unrealized","roi_total","roi_low","roi_high","capital_required","pools","trades"]},"Token":{"type":"object","description":"Token information","properties":{"network":{"$ref":"#/components/schemas/BlockchainNetwork"},"address":{"type":["string"],"description":"Token address"},"name":{"type":["string","null"],"description":"Token name"},"symbol":{"type":["string","null"],"description":"Token symbol"},"scam_status":{"type":["string","null"],"description":"Scam check status","enum":["ok","scam","undefined","checking","check_fail"]},"created_at":{"type":"integer","description":"Token creation time. Timestamp in seconds."},"started_at":{"type":["integer","null"],"description":"Token trading start time (first swap). Timestamp in seconds."}},"required":["network","address","name","symbol","scam_status","created_at","started_at"]},"DealStatus":{"type":"string","description":"Deal status.\n`open` - Deal is open.\n`closed` - Deal is closed.\n`send_receive` - Deal has send or receive operations.\n`scam` - Deal is marked as a scam.\n`oversell` - More sold than bought.\n","enum":["open","closed","send_receive","scam","oversell"]},"IndicatorPnlValues":{"type":"object","description":"PNL indicator values","properties":{"initial":{"$ref":"#/components/schemas/PnlValue"},"following":{"oneOf":[{"$ref":"#/components/schemas/PnlValue"},{"type":"null"}]}},"required":["initial","following"]},"PnlValue":{"type":["number"],"description":"PNL value in USD ($)"},"IndicatorRoiValues":{"type":"object","description":"ROI indicator values","properties":{"initial":{"$ref":"#/components/schemas/RoiValue"},"following":{"oneOf":[{"$ref":"#/components/schemas/RoiValue"},{"type":"null"}]}},"required":["initial","following"]},"RoiValue":{"type":["number"],"description":"ROI value in percent (%)"},"IndicatorCapitalRequiredValues":{"type":"object","description":"Capital required indicator values.","properties":{"initial":{"$ref":"#/components/schemas/InvestmentAmountValue"},"following":{"oneOf":[{"$ref":"#/components/schemas/InvestmentAmountValue"},{"type":"null"}]}},"required":["initial","following"]},"InvestmentAmountValue":{"type":["number"],"description":"Investment amount value in USD ($)"},"Pool":{"type":"object","description":"DEX Liquidity pool","properties":{"type":{"type":["string"],"description":"Pool type"},"address":{"type":["string"],"description":"Pool address"},"name":{"type":["string","null"],"description":"Pool name"}},"required":["type","address","name"]},"Trade":{"type":"object","description":"Trade operation","properties":{"id":{"type":["integer"],"description":"Trade ID"},"is_following":{"type":"boolean","description":"Trade is calculated by following strategy"},"type":{"type":["string"],"description":"Trade type","enum":["buy","sell","approve"]},"transaction_hash":{"type":["string","null"]},"application":{"oneOf":[{"$ref":"#/components/schemas/RouterApplication"},{"type":"null"}]},"usd_amount":{"type":["number","null"],"description":"Trade amount in USD ($)"},"quantity":{"type":["number"],"description":"Trade token amount"},"quantity_unlimited":{"type":["boolean"],"description":"Unlimited token amount. For `approve` trades"},"usd_price":{"type":["number","null"],"description":"Trade price in USD ($)"},"usd_liquidity":{"type":["number","null"],"description":"Trade token liquidity in USD ($)"},"usd_market_cap":{"type":["number","null"],"description":"Trade token market cap in USD ($)"},"token_age":{"type":["number","null"],"description":"Amount of minutes passed from token trading start time"},"time":{"type":["integer"],"description":"Time of trade operation. Timestamp in seconds"},"pools":{"type":"array","description":"Used pools","items":{"$ref":"#/components/schemas/Pool"}},"coin_fee":{"type":"object","description":"Coin fee values","properties":{"amount":{"type":["number"],"description":"Coin fee amount"},"percent":{"type":["number"],"description":"Coin fee percent (%)"}},"required":["amount","percent"]},"router_fee":{"type":"object","description":"Router fee values","properties":{"usd":{"type":["number"],"description":"Router fee amount in USD ($)"},"native":{"type":["number"],"description":"Router fee amount in native currency"}},"required":["usd","native"]},"network_fee":{"type":"object","description":"Network fee values","properties":{"usd":{"type":["number"],"description":"Network fee amount in USD ($)"},"native":{"type":["number"],"description":"Network fee amount in native currency"}},"required":["usd","native"]},"swaps":{"type":"array","description":"List of executed swaps","items":{"type":"object","description":"Swap information","properties":{"from":{"type":"object","description":"Send swap data","properties":{"amount":{"type":"number","description":"Sent token amount"},"symbol":{"$ref":"#/components/schemas/Token/properties/symbol"},"address":{"$ref":"#/components/schemas/Token/properties/address"}},"required":["amount","symbol","address"]},"to":{"type":"object","description":"Receive swap data","properties":{"amount":{"type":["number"],"description":"Received token amount"},"symbol":{"$ref":"#/components/schemas/Token/properties/symbol"},"address":{"$ref":"#/components/schemas/Token/properties/address"}},"required":["amount","symbol","address"]},"pool":{"oneOf":[{"$ref":"#/components/schemas/Pool"},{"type":"null"}]},"usd_price":{"type":["number","null"],"description":"Exchange price in USD ($)"}},"required":["from","to","pool","usd_price"]}}},"required":["id","is_following","type","transaction_hash","application","usd_amount","quantity","quantity_unlimited","usd_price","usd_liquidity","usd_market_cap","token_age","time","pools","coin_fee","router_fee","network_fee","swaps"]},"RouterApplication":{"type":"object","description":"Router application information","properties":{"name":{"type":["string","null"]},"address":{"type":["string"]}},"required":["name","address"]},"PagePagination":{"type":"object","properties":{"current":{"type":"integer","description":"Current page number"},"per_page":{"type":"integer","description":"Number of items per page"},"total_pages":{"type":"integer","description":"Total number of pages"},"total_items":{"type":"integer","description":"Total number of items"}},"required":["current","per_page"]},"ResponseCredits":{"type":"object","description":"Credits data after request","properties":{"spent":{"type":"integer","description":"Credits spent on the request"},"remaining":{"type":"integer","description":"Remaining credits"}},"required":["spent","remaining"]}},"responses":{"400BadRequest":{"description":"Request fail","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}},"401Unauthorized":{"description":"API Key invalid or missing"},"403Forbidden":{"description":"API access forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}}}},"paths":{"/wallets/{address}/deals":{"get":{"description":"Returns wallet deals. \nWhen the `from_time` or `to_time` fields are specified, \ndeals will be filtered and recalculated for the given time range.\n","tags":["wallet"],"parameters":[{"$ref":"#/components/parameters/WalletAddressPathParam"},{"$ref":"#/components/parameters/BlockchainNetworkQueryParam"},{"name":"page","in":"query","description":"Page number for pagination","schema":{"type":["integer"],"minimum":1,"default":1}},{"name":"per_page","in":"query","description":"Number of items to return per page","schema":{"type":["integer"],"minimum":1,"maximum":150,"default":30}},{"name":"search","in":"query","description":"Search string.\nSearches by partial token name, complete symbol, or full token address. Case-insensitive.\n","schema":{"type":["string"],"maxLength":128}},{"$ref":"#/components/parameters/FromTimeQueryParam"},{"$ref":"#/components/parameters/ToTimeQueryParam"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"deals":{"type":"array","description":"List of deals","items":{"$ref":"#/components/schemas/Deal"}},"page":{"$ref":"#/components/schemas/PagePagination"}},"required":["deals","page"]},"credits":{"$ref":"#/components/schemas/ResponseCredits"}},"required":["result","credits"]}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"}}}}}} ``` # Wallet investment amount chart Request cost: 1 credits ## GET /wallets/{address}/charts/investment\_amount > Returns wallet investment amount chart data.\ > Require period or custom time to be set. \ > To set custom time interval use \`from\_time\` and \`to\_time\` params.
```json {"openapi":"3.1.0","info":{"title":"Analytics API","version":"1.0.4"},"tags":[{"name":"wallet","description":"Wallet"}],"servers":[{"url":"https://definest.ai/api/analytics/v1","description":"Production server"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"parameters":{"WalletAddressPathParam":{"name":"address","in":"path","description":"Wallet address","required":true,"schema":{"$ref":"#/components/schemas/Wallet/properties/address"}},"BlockchainNetworkQueryParam":{"name":"network","in":"query","description":"Blockchain network","required":true,"schema":{"$ref":"#/components/schemas/BlockchainNetwork"}},"PeriodQueryParam":{"name":"period","in":"query","description":"Time period","schema":{"$ref":"#/components/schemas/Period"}},"FromTimeQueryParam":{"name":"from_time","in":"query","description":"Timestamp in seconds. \nMinimum time for the deal's first trade.\nDeals started before this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}},"ToTimeQueryParam":{"name":"to_time","in":"query","description":"Timestamp in seconds. \nMaximum time for deal trades. \nTrades executed after this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}}},"schemas":{"Wallet":{"properties":{"address":{"type":"string","description":"Wallet address"}}},"BlockchainNetwork":{"type":"string","enum":["eth","sol"],"description":"Supported blockchain networks"},"Period":{"type":"string","description":"Time period","enum":["12h","24h","2d","3d","7d","10d","14d","20d","1m","2m","3m","6m","1y","2y"]},"InvestmentAmountChart":{"type":"object","description":"Investment amount chart data","properties":{"timestamps":{"$ref":"#/components/schemas/ChartTimestampsArray"},"values":{"type":"array","description":"Array of investment amount values corresponding to each timestamp. In USD ($)","items":{"type":["integer"],"description":"Investment amount in USD ($) at the given timestamp"}},"period":{"$ref":"#/components/schemas/ChartPeriod"}},"required":["timestamps","values","period"]},"ChartTimestampsArray":{"type":"array","description":"Array of timestamps for each data point","items":{"type":["integer"],"description":"UNIX timestamp in seconds"}},"ChartPeriod":{"type":"object","properties":{"start":{"type":["integer"],"description":"Start timestamp of the chart period in seconds"},"end":{"type":["integer"],"description":"End timestamp of the chart period in seconds"}},"required":["start","end"]},"ResponseCredits":{"type":"object","description":"Credits data after request","properties":{"spent":{"type":"integer","description":"Credits spent on the request"},"remaining":{"type":"integer","description":"Remaining credits"}},"required":["spent","remaining"]}},"responses":{"400BadRequest":{"description":"Request fail","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}},"401Unauthorized":{"description":"API Key invalid or missing"},"403Forbidden":{"description":"API access forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}}}},"paths":{"/wallets/{address}/charts/investment_amount":{"get":{"description":"Returns wallet investment amount chart data.\nRequire period or custom time to be set. \nTo set custom time interval use `from_time` and `to_time` params.\n","tags":["wallet"],"parameters":[{"$ref":"#/components/parameters/WalletAddressPathParam"},{"$ref":"#/components/parameters/BlockchainNetworkQueryParam"},{"$ref":"#/components/parameters/PeriodQueryParam"},{"$ref":"#/components/parameters/FromTimeQueryParam"},{"$ref":"#/components/parameters/ToTimeQueryParam"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"chart":{"$ref":"#/components/schemas/InvestmentAmountChart"}},"required":["chart"]},"credits":{"$ref":"#/components/schemas/ResponseCredits"}},"required":["result","credits"]}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"}}}}}} ``` # Wallet PNL chart Request cost: 1 credits ## GET /wallets/{address}/charts/pnl > Returns wallet PNL chart data.\ > Require period or custom time to be set. \ > To set custom time interval use \`from\_time\` and \`to\_time\` params.
```json {"openapi":"3.1.0","info":{"title":"Analytics API","version":"1.0.4"},"tags":[{"name":"wallet","description":"Wallet"}],"servers":[{"url":"https://definest.ai/api/analytics/v1","description":"Production server"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"parameters":{"WalletAddressPathParam":{"name":"address","in":"path","description":"Wallet address","required":true,"schema":{"$ref":"#/components/schemas/Wallet/properties/address"}},"BlockchainNetworkQueryParam":{"name":"network","in":"query","description":"Blockchain network","required":true,"schema":{"$ref":"#/components/schemas/BlockchainNetwork"}},"PeriodQueryParam":{"name":"period","in":"query","description":"Time period","schema":{"$ref":"#/components/schemas/Period"}},"FromTimeQueryParam":{"name":"from_time","in":"query","description":"Timestamp in seconds. \nMinimum time for the deal's first trade.\nDeals started before this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}},"ToTimeQueryParam":{"name":"to_time","in":"query","description":"Timestamp in seconds. \nMaximum time for deal trades. \nTrades executed after this time will be excluded from result and calculations.\n","schema":{"type":["integer","number"],"minimum":1}}},"schemas":{"Wallet":{"properties":{"address":{"type":"string","description":"Wallet address"}}},"BlockchainNetwork":{"type":"string","enum":["eth","sol"],"description":"Supported blockchain networks"},"Period":{"type":"string","description":"Time period","enum":["12h","24h","2d","3d","7d","10d","14d","20d","1m","2m","3m","6m","1y","2y"]},"PnlChart":{"type":"object","description":"PNL chart data","properties":{"timestamps":{"$ref":"#/components/schemas/ChartTimestampsArray"},"initial_values":{"type":"array","description":"Array of initial PNL values corresponding to each timestamp. In USD ($)","items":{"$ref":"#/components/schemas/PnlValue"}},"following_values":{"type":"array","description":"Array of following PNL values corresponding to each timestamp. In USD ($)","items":{"$ref":"#/components/schemas/PnlValue"}},"period":{"$ref":"#/components/schemas/ChartPeriod"}},"required":["timestamps","initial_values","following_values","period"]},"ChartTimestampsArray":{"type":"array","description":"Array of timestamps for each data point","items":{"type":["integer"],"description":"UNIX timestamp in seconds"}},"PnlValue":{"type":["number"],"description":"PNL value in USD ($)"},"ChartPeriod":{"type":"object","properties":{"start":{"type":["integer"],"description":"Start timestamp of the chart period in seconds"},"end":{"type":["integer"],"description":"End timestamp of the chart period in seconds"}},"required":["start","end"]},"ResponseCredits":{"type":"object","description":"Credits data after request","properties":{"spent":{"type":"integer","description":"Credits spent on the request"},"remaining":{"type":"integer","description":"Remaining credits"}},"required":["spent","remaining"]}},"responses":{"400BadRequest":{"description":"Request fail","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}},"401Unauthorized":{"description":"API Key invalid or missing"},"403Forbidden":{"description":"API access forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}}}},"paths":{"/wallets/{address}/charts/pnl":{"get":{"description":"Returns wallet PNL chart data.\nRequire period or custom time to be set. \nTo set custom time interval use `from_time` and `to_time` params.\n","tags":["wallet"],"parameters":[{"$ref":"#/components/parameters/WalletAddressPathParam"},{"$ref":"#/components/parameters/BlockchainNetworkQueryParam"},{"name":"type","in":"query","description":"PNL type. Only `realized` is available","schema":{"type":["string"],"enum":["realized"],"default":"realized"}},{"$ref":"#/components/parameters/PeriodQueryParam"},{"$ref":"#/components/parameters/FromTimeQueryParam"},{"$ref":"#/components/parameters/ToTimeQueryParam"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"chart":{"$ref":"#/components/schemas/PnlChart"}},"required":["chart"]},"credits":{"$ref":"#/components/schemas/ResponseCredits"}},"required":["result","credits"]}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"}}}}}} ``` # Copy Trade Simulator Request cost: 10 credits ## POST /wallets/simulator > Simulate wallets copy trading results ```json {"openapi":"3.1.0","info":{"title":"Analytics API","version":"1.0.4"},"tags":[{"name":"wallet","description":"Wallet"}],"servers":[{"url":"https://definest.ai/api/analytics/v1","description":"Production server"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"schemas":{"Wallet":{"properties":{"address":{"type":"string","description":"Wallet address"}}},"BlockchainNetwork":{"type":"string","enum":["eth","sol"],"description":"Supported blockchain networks"},"PnlValue":{"type":["number"],"description":"PNL value in USD ($)"},"RoiValue":{"type":["number"],"description":"ROI value in percent (%)"},"TradingVolumeValue":{"type":["number"],"description":"Trading volume value in USD ($)"},"InvestmentAmountValue":{"type":["number"],"description":"Investment amount value in USD ($)"},"ChartTimestampsArray":{"type":"array","description":"Array of timestamps for each data point","items":{"type":["integer"],"description":"UNIX timestamp in seconds"}},"SimulatedDeal":{"type":"object","description":"Simulated deal information","properties":{"open_time":{"type":["integer"],"description":"Opening time. Timestamp in seconds"},"last_operation_time":{"type":["integer"],"description":"Last operation time. Timestamp in seconds"},"status":{"type":["string"],"enum":["open","closed"]},"token":{"type":"object","description":"Token information","properties":{"name":{"$ref":"#/components/schemas/Token/properties/name"},"symbol":{"$ref":"#/components/schemas/Token/properties/symbol"},"address":{"$ref":"#/components/schemas/Token/properties/address"}},"required":["name","symbol","address"]},"pnl_realized":{"$ref":"#/components/schemas/PnlValue"},"pnl_unrealized":{"$ref":"#/components/schemas/PnlValue"},"pnl_total":{"$ref":"#/components/schemas/PnlValue"},"roi_realized":{"$ref":"#/components/schemas/RoiValue"},"roi_total":{"$ref":"#/components/schemas/RoiValue"},"usd_slippage_loss":{"type":["number"],"description":"Slippage loss in USD ($)"},"usd_network_fee":{"type":["number"],"description":"Network fee in USD ($)"},"usd_bot_fee":{"type":["number"],"description":"Bot fee in USD ($)"},"investment_amount":{"$ref":"#/components/schemas/InvestmentAmountValue"},"trades_number":{"type":["integer"],"description":"Number of trades in deal"},"closed_position":{"type":["number","integer"],"description":"Close position percent (%)"},"special_tag":{"type":["string","null"],"enum":["sell_timefix_final","sell_timefix","close_all"],"description":"Special tag.\n`sell_timefix_final` - closed by final timefix operation\n`sell_timefix` - closed by timefix operation in the middle of deal\n`close_all` - closed by close_all setting\n"},"trades":{"type":"array","description":"Array of simulated trade operations","items":{"$ref":"#/components/schemas/SimulatedTrade"}}},"required":["open_time","last_operation_time","status","token","pnl_realized","pnl_unrealized","pnl_total","roi_realized","roi_total","roi_total","usd_slippage_loss","usd_network_fee","usd_bot_fee","investment_amount","trades_number","closed_position","special_tag","trades"]},"Token":{"properties":{"name":{"type":["string","null"],"description":"Token name"},"symbol":{"type":["string","null"],"description":"Token symbol"},"address":{"type":["string"],"description":"Token address"}}},"SimulatedTrade":{"type":"object","description":"Simulated trade operation","properties":{"type":{"type":["string"],"description":"Operation type. \n`buy` - basic buy operation\n`sell` - basic sell operation\n`sell_timefix` - Time fix sell operation in the middle of deal\n`sell_timefix_final` - Time fix sell operation in the end of deal\n","enum":["buy","sell","sell_timefix","sell_timefix_final"]},"time":{"$ref":"#/components/schemas/Trade/properties/time"},"usd_amount":{"$ref":"#/components/schemas/Trade/properties/usd_amount"},"quantity":{"$ref":"#/components/schemas/Trade/properties/quantity"},"usd_price":{"$ref":"#/components/schemas/Trade/properties/usd_price"},"usd_liquidity":{"$ref":"#/components/schemas/Trade/properties/usd_liquidity"},"usd_buy_price_avg":{"type":["number"],"description":"Current average purchase price in USD ($)"},"usd_invested":{"type":["number"],"description":"Current invested amount in USD ($)"},"slippage":{"type":["number"],"description":"Slippage percent (%)"},"usd_network_fee":{"$ref":"#/components/schemas/Trade/properties/network_fee/properties/usd"},"usd_bot_fee":{"type":["number"],"description":"Bot fee in USD ($)"}},"required":["type","time","usd_amount","quantity","usd_price","usd_liquidity","usd_buy_price_avg","usd_invested","slippage","usd_network_fee","usd_bot_fee"]},"Trade":{"properties":{"time":{"type":["integer"],"description":"Time of trade operation. Timestamp in seconds"},"usd_amount":{"type":["number","null"],"description":"Trade amount in USD ($)"},"quantity":{"type":["number"],"description":"Trade token amount"},"usd_price":{"type":["number","null"],"description":"Trade price in USD ($)"},"usd_liquidity":{"type":["number","null"],"description":"Trade token liquidity in USD ($)"},"network_fee":{"properties":{"usd":{"type":["number"],"description":"Network fee amount in USD ($)"}}}}}},"responses":{"400BadRequest":{"description":"Request fail","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}},"401Unauthorized":{"description":"API Key invalid or missing"},"403Forbidden":{"description":"API access forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error short code"},"detail":{"description":"Detailed error description"}},"required":["code"]}}}}}},"paths":{"/wallets/simulator":{"post":{"tags":["wallet"],"description":"Simulate wallets copy trading results","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Simulation input data","properties":{"wallets":{"type":"array","description":"List of wallets to follow","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/Wallet/properties/address"}},"network":{"$ref":"#/components/schemas/BlockchainNetwork"},"from_date":{"type":["string"],"description":"Time interval start date. UTC timezone. YYYY-MM-DD format"},"to_date":{"type":["string"],"description":"Time interval end date. UTC timezone. YYYY-MM-DD format"},"buy_percentage":{"type":["integer"],"description":"Copy trading buy percentage (%)","exclusiveMinimum":0},"max_buy_amount":{"type":["number"],"description":"Maximum purchase amount, in USD ($)","exclusiveMinimum":0},"max_position_amount":{"type":["number"],"description":"Maximum position amount per deal, in USD ($)","exclusiveMinimum":0},"priority_fee":{"type":["number"],"description":"Priority fee amount, in network native currency","minimum":0},"bribe":{"type":["number"],"description":"Bribe amount, in network native currency","minimum":0},"max_dupe_buy_times":{"type":["integer"],"description":"Maximum number of additional purchases","minimum":0},"close_all":{"type":["boolean"],"description":"Close deal on first sell","default":false},"inactivity_time_fix":{"type":["null","object"],"description":"Setting for automatic deal closure when there is no activity\n","default":null,"properties":{"hours":{"type":["integer"],"minimum":1,"maximum":192,"description":"Number of hours of inactivity"}},"required":["hours"]},"include_bot_fees":{"type":["boolean"],"description":"Include fees in calculations","default":false}},"required":["wallets","network","from_date","to_date","buy_percentage","max_buy_amount","max_position_amount","priority_fee","bribe","max_dupe_buy_times"]}}}},"responses":{"200":{"description":"Simulation result","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"object","description":"Wallets indicators summary","properties":{"pnl_total":{"$ref":"#/components/schemas/PnlValue"},"pnl_realized":{"$ref":"#/components/schemas/PnlValue"},"pnl_unrealized":{"$ref":"#/components/schemas/PnlValue"},"roi_total":{"$ref":"#/components/schemas/RoiValue"},"roi_realized":{"$ref":"#/components/schemas/RoiValue"},"bot_fees":{"type":["number"],"description":"Bot fees in USD ($)"},"network_fees":{"type":["number"],"description":"Network fees in USD ($)"},"linearity_r2_closed_deals":{"type":["number"],"description":"Linearity R2 (Closed Deals)"},"top_deal_dominance":{"type":["number"],"description":"Top Deal Dominance. In percent (%)"},"trading_volume":{"$ref":"#/components/schemas/TradingVolumeValue"},"slippage_loss":{"type":["number"],"description":"Slippage Loss in USD ($)"},"investment_amount":{"$ref":"#/components/schemas/InvestmentAmountValue"},"investment_amount_closed_deals":{"$ref":"#/components/schemas/InvestmentAmountValue"},"investment_amount_open_deals":{"$ref":"#/components/schemas/InvestmentAmountValue"}},"required":["pnl_total","pnl_realized","pnl_unrealized","roi_total","roi_realized","bot_fees","network_fees","linearity_r2_closed_deals","top_deal_dominance","trading_volume","slippage_loss","investment_amount","investment_amount_closed_deals","investment_amount_open_deals"]},"cumulative_pnl_and_fee_chart":{"type":"object","description":"Cumulative PnL and Fees chart","properties":{"pnl_realized":{"type":"array","description":"Array of realized PNL values for each data point","items":{"$ref":"#/components/schemas/PnlValue"}},"pnl_unrealized":{"type":"array","description":"Array of unrealized PNL values for each data point","items":{"$ref":"#/components/schemas/PnlValue"}},"pnl_total":{"type":"array","description":"Array of total PNL values for each data point","items":{"$ref":"#/components/schemas/PnlValue"}},"fee_sum":{"type":"array","description":"Array of fee sum values for each data point","items":{"type":"number","description":"Fee sum value in USD ($)"}},"bot_fee":{"type":"array","description":"Array of bot fee values for each data point","items":{"type":"number","description":"Bot fee value in USD ($)"}},"deal_indexes":{"type":"array","description":"Array of deal index for each data point","items":{"type":["integer"],"description":"Deal index"}},"timestamps":{"$ref":"#/components/schemas/ChartTimestampsArray"}},"required":["pnl_realized","pnl_unrealized","pnl_total","fee_sum","bot_fee","deal_indexes","timestamps"]},"cumulative_usd_closed_deals_chart":{"type":"object","description":"Cumulative USD for closed deals chart","properties":{"values":{"type":"array","description":"Array of USD ($) values corresponding to each timestamp","items":{"type":["integer"],"description":"USD ($) value at the given timestamp"}},"timestamps":{"$ref":"#/components/schemas/ChartTimestampsArray"}},"required":["values","timestamps"]},"cumulative_usd_open_deals_chart":{"type":"object","description":"Cumulative USD for still open deals chart","properties":{"values":{"type":"array","description":"Array of USD ($) values corresponding to each timestamp","items":{"type":["integer"],"description":"USD ($) value at the given timestamp"}},"timestamps":{"$ref":"#/components/schemas/ChartTimestampsArray"}},"required":["values","timestamps"]},"deals":{"type":"array","description":"Array of deals","items":{"$ref":"#/components/schemas/SimulatedDeal"}}},"required":["summary","cumulative_pnl_and_fee_chart","cumulative_usd_closed_deals_chart","cumulative_usd_open_deals_chart","deals"]}}}},"400":{"$ref":"#/components/responses/400BadRequest"},"401":{"$ref":"#/components/responses/401Unauthorized"},"403":{"$ref":"#/components/responses/403Forbidden"}}}}}} ``` # Supported Chains and DEXs ### Supported Chains & DEXs
ChainPlatform for wallet searchTrading Bot
EthereumUniswap v2, v3Uniswap v2, v3
SolanaRaydium AMM, PumpFun, PumpSwap, Raydium CPMM, Raydium CLMM, Raydium Launchpad, Orca, Meteora DLMM, Meteora Pools Program, Phoenix, Lifinity V2, Fluxbeam, Moonshot, ZeroFi, Invariant, Bonkswap, 1DEX, SOLFi, Saber Stable Swap, Stabble Swap, Penguin Finance, Saros AMM, Numeraire, Cropper Finance, Virtuals, DEXLAB Swap, Stabble Weighted Swap, Sanctum Program, Obric V2, Aldrin AMM V2, Daos Fun, Guac Swap, Helium Treasury Management, Crema Finance, Oasis Program, Sentre Swap, Orca Token Swap, Orca Token Swap V2, SWAP Program, StepN DOOAR Swap', Openbook V2, Cropper Whirlpool, Mercurial Stable Swap, Aldrin AMMRaydium AMM, PumpFun, PumpSwap, Raydium CPMM, Raydium CLMM, Orca, Meteora DLMM, Fluxbeam, Moonshot, Jupiter Aggregator
Binance Smart Chainsoonsoon
# Cut-off dates Cut-off date in our context is a specific date from which historical trading data of cryptocurrency wallets becomes available. All data prior to this date is excluded from analysis and is not displayed in the service.
ChainCut-off date
EthereumSeptember 1, 2023
SolanaFebruary 1, 2025
Binance Smart Chainsoon
# Trading bot fees Successful transactions through the Definest CopyTrading Bot (manually or automatically) will be charged a 1% tax on every buy & sell. Simple transfers are NOT taxed. ## Fee Extraction Mechanism ### Solana Fees will be directly extracted in the same transaction. ### Other Chains The bot will NOT take the 1% directly from each transaction. It simply accumulates how much you owe us, and doesn't extract any fees until you accumulate more than 0.01 ETH in unpaid fees. The fees accumulate per **Definest** account, **NOT** per wallet, and the bot will always extract the fee from the wallet with the **highest balance** in the concerned chain. The bot will deal with this silently, and you can always verify your trading volume by checking your block explorer. # Credits & Pricing plans ## **What are Credits?** Credits are necessary for searching wallets and viewing wallet pages. Your current credit balance is displayed in the upper right corner:
* Viewing one wallet page costs 1 credit per day. This means you can refresh the wallet page within a day without incurring additional charges. * One wallets search costs 5 credits per day or until the filter is changed. * Each subsequent search results page also costs 5 credits per day. Credits for the previously opened page are not deducted. You can go back to previous pages and refresh them for free. ## Pricing plans There are a total of 1 paid subscription plans available: Premium. You can review the full terms and prices on the Plan page - . ## **15% Discount for Annual Subscription** Yes, discounts can be combined! Subscribe to our Telegram, choose an annual subscription, and receive a discount of approximately 40%!
## **Differences Between Tariff Plans** The higher the tariff plan, the more opportunities there are for successfully searching for wallets and the greater the functionality of the Copy Trading bot. * Different tariff plans provide different amounts of Credits. * API * .. # Referral Program {% hint style="info" %} If you're bringing many users with good volume through your referrals, please contact our marketer for a custom deal on your referral percentage. {% endhint %} Only Definest offers an amazing three-tier referral program! For first-level referrals, you will receive 40% of the service’s profit, for second-level referrals 3%, and for third-level referrals 2%. {% hint style="success" %} The most generous referral program on the market! We give you 45% of all profits! {% endhint %} ## **How the Referral Program Works** 1. Find your referral link or invitation code in the "Invite Friends" section. 2. Invite friends to register using your link or code. 3. Earn 40% from each of their premium account purchases and 40% from the trading bot's commission. 4. Encourage them to invite new friends and earn 3% from second-level referrals and 2% from third-level referrals! 5. Withdraw your earnings. ## **Withdrawing Referral Earnings** 1. Go to the "Invite Friends" page. 2. Click on the **Withdrawal** button. 3. Choose one of the available cryptocurrency networks. 4. Enter your wallet address in that network. 5. Specify the amount to withdraw (no more than the **Available for Withdrawal**) and click **Withdraw**. {% hint style="warning" %} Ensure you provide a correct wallet address and the corresponding network. Otherwise, the funds will be lost permanently. {% endhint %} # Privacy Policy *Last Updated: October 1, 2024* **Contact Email:** *** Definest.ai ("Company," "we," "us," or "our") is committed to protecting your privacy. This Privacy Policy explains how we collect, use, disclose, and safeguard your personal information when you access or use our website ("Website") and any related services ("Services"). By accessing or using our Services, you agree to this Privacy Policy and the accompanying Terms of Service. If you do not agree with the terms, please do not access or use the Services. *** ### 1. Introduction We value your privacy and strive to protect your personal information. This Privacy Policy outlines: * What personal data we collect about you. * How we collect your personal data. * How we use your personal data. * How we share your personal data. * Your rights regarding your personal data. * How we protect your personal data. * Children's privacy. * Changes to this Privacy Policy. * Contact information. In accordance with applicable data protection laws, Definest.ai is the data controller responsible for your personal data. ### 2. Information We Collect #### 2.1 Personal Data We Collect We may collect the following types of personal data ("Personal Data"): * **Contact Information**: Email address and any other contact details you provide. * **Usage Data**: Information about how you use our Services, including interactions, preferences, and settings. * **Technical Data**: IP address, browser type, operating system, device information, and referral URLs. * **Transaction Data**: Details about transactions you perform through our Services, including blockchain transactions involving virtual assets. * **Communication Data**: Correspondence between you and us, including emails, customer support inquiries, and social media interactions. * **Cookies and Similar Technologies**: Information collected through cookies, web beacons, and other tracking technologies (see Section 9 for more details). #### 2.2 Non-Personal Data We may collect non-personal data that does not directly identify you, such as aggregated statistical information. #### 2.3 Sensitive Personal Data We do not intentionally collect sensitive personal data, such as health information, political opinions, or religious beliefs. **We do not collect personal identity information such as full name, date of birth, gender, nationality, or government-issued identification documents.** Please refrain from providing such information through our Services. ### 3. How We Collect Personal Data We collect Personal Data about you in the following ways: #### 3.1 Information You Provide Voluntarily * **Service Interaction**: Information you provide when interacting with our Services, such as subscribing to updates or filling out forms. * **Customer Support**: Information you provide when contacting us for support or inquiries. #### 3.2 Information Collected Automatically * **Usage Data**: Information about your interactions with our Services. * **Device Data**: Technical information about the devices you use to access our Services. * **Location Data**: Information about your location based on your IP address or device settings. #### 3.3 Information from Third Parties We may receive information about you from third parties, such as analytics providers or advertising networks. ### 4. How We Use Your Personal Data We use your Personal Data for the following purposes: #### 4.1 Providing and Improving Our Services * **Operational Purposes**: To operate and maintain our Services. * **Customer Support**: To respond to your inquiries and provide assistance. * **Service Enhancement**: To analyze and improve our Services and user experience. #### 4.2 Legal Compliance * **Regulatory Compliance**: To comply with applicable laws, regulations, and legal processes. * **Fraud Prevention**: To detect and prevent fraud, security breaches, or other potentially prohibited or illegal activities. #### 4.3 Communication with You * **Transactional Communications**: To send you notifications, updates, and security alerts. * **Marketing Communications**: To provide you with information about our Services, promotions, and news (you may opt out at any time). #### 4.4 Security and Fraud Prevention * **Monitoring**: To monitor activities for security and fraud prevention purposes. * **Risk Management**: To assess and mitigate risks related to your use of our Services. #### 4.5 With Your Consent * **Personalization**: To personalize your experience and provide content tailored to your interests. * **Additional Purposes**: Any other purposes disclosed to you at the time we collect your information. ### 5. Legal Basis for Processing Data We process your Personal Data based on the following legal grounds: * **Consent**: Where you have given us explicit consent for specific purposes. * **Contractual Necessity**: To provide you with our Services in accordance with our Terms of Service. * **Legal Obligations**: To comply with our legal and regulatory obligations. * **Legitimate Interests**: To protect our legitimate interests, provided that this does not override your rights and freedoms. ### 6. How We Share Your Personal Data We do not sell or rent your Personal Data to third parties, except in the following circumstances: #### 6.1 Service Providers We may share your Personal Data with trusted third-party service providers who perform services on our behalf, such as: * **Cloud Service Providers** * **Analytics Services** * **Customer Support Platforms** These providers are obligated to maintain the confidentiality of your data and are restricted from using your data for any other purposes. #### 6.2 Legal and Regulatory Compliance We may disclose your Personal Data if required to do so by law or in response to valid requests by public authorities. #### 6.3 Business Transactions In the event of a merger, acquisition, or sale of all or a portion of our assets, your Personal Data may be transferred to the acquiring entity. #### 6.4 With Your Consent We may disclose your Personal Data with your prior consent. ### 7. International Data Transfers We do not provide Services to users located in the following jurisdictions: * United States of America * European Union * Other jurisdictions listed as prohibited in our Terms of Service If you are located in any of these jurisdictions, please do not use our Services or provide us with any Personal Data. ### 8. Your Rights Please note that, as per our Terms of Service, we do not provide the following rights: * **Right to Access and Correction**: We do not offer the ability to request access to or correction of your Personal Data. * **Right to Data Portability**: We do not offer the ability to request the transfer of your Personal Data. ### 9. Cookies and Similar Technologies #### 9.1 What Are Cookies? Cookies are small text files stored on your device when you visit a website. They help us recognize you and store your preferences. #### 9.2 How We Use Cookies We use cookies to: * **Functionality**: Ensure our Services operate correctly. * **Analytics**: Collect statistical information about the use of our Services. * **Personalization**: Remember your preferences and settings. #### 9.3 Managing Cookies You can manage cookies through your browser settings. Please note that disabling cookies may affect the functionality of our Services. ### 10. Data Security We take reasonable measures to protect your Personal Data from unauthorized access or disclosure. However, no method of transmission over the internet or electronic storage is completely secure. Therefore, we cannot guarantee absolute security. ### 11. Children's Privacy Our Services are not intended for individuals under the age of 18. We do not knowingly collect Personal Data from such individuals. If you believe that a child has provided us with Personal Data, please contact us, and we will take steps to delete such information. ### 12. Changes to This Privacy Policy We may update this Privacy Policy from time to time. The updated version will be posted on this page with an updated "Last Updated" date. Your continued use of the Services after any changes constitutes acceptance of the new Privacy Policy. ### 13. Contact Information If you have any questions or comments about this Privacy Policy, please contact us: * **Email**: *** **Note**: This Privacy Policy reflects Definest.ai's data collection and usage practices, acknowledging that we **do not work with users from the USA, European Union, and other prohibited jurisdictions**, and that we **do not provide rights to access and correction or data portability**. This Policy is provided for informational purposes and does not constitute legal advice. We recommend consulting legal counsel to ensure full compliance with all applicable laws and regulations. # Terms of Service *Last Updated: October 1, 2024* **Contact Email:** *** **PLEASE READ THESE TERMS CAREFULLY AS THEY GOVERN YOUR RELATIONSHIP WITH DEFINEST.AI. BY ACCESSING OR USING THE SERVICES, YOU ACKNOWLEDGE THAT YOU HAVE READ, UNDERSTOOD, AND AGREE TO BE BOUND BY THESE TERMS AND CONDITIONS. IF YOU DO NOT AGREE WITH ANY PART OF THESE TERMS, YOU MUST NOT USE THE SERVICE. THIS AGREEMENT CONTAINS A BINDING ARBITRATION CLAUSE AND CLASS ACTION WAIVER THAT AFFECT YOUR RIGHTS ABOUT HOW TO RESOLVE DISPUTES. PLEASE READ IT CAREFULLY.** *** ### 1. Acceptance of Terms By accessing or using Definest.ai ("the Service"), you agree to be bound by these Terms of Service ("Terms"). These Terms constitute a legal and binding contract between you ("User" or "you") and Definest.ai ("Company," "we," "us," or "our"). If you do not agree with any part of these Terms, you must not use the Service. ### 2. Definitions and Interpretation #### 2.1 Definitions * **"Agreement"** includes these Terms of Service and all other agreements, acknowledgments, and authorizations executed by the User in connection with the use of the Services. * **"Content"** means any data, information, documents, or images provided on the Website, through the Services, or via our software applications, including any information on our social media platforms. * **"Eligible Person"** means a person who meets all the criteria outlined in Section 3.1. * **"Intellectual Property Rights"** include all intellectual property rights, whether registered or unregistered, such as patents, trademarks, trade secrets, copyrights, database rights, design rights, and any other proprietary rights. * **"Prohibited Activities"** are activities listed in Section 6.5. * **"Prohibited Jurisdiction"** refers to jurisdictions listed in Section 3.2. * **"Services"** refer to all services provided by Definest.ai, including the Wallet Finder and Copy Trading Bot. * **"User Content"** means any content, feedback, suggestions, ideas, or other information or materials about the Company or the Services that you provide to us. * **"Virtual Assets"** mean cryptocurrencies or digital assets that are based on blockchain or distributed ledger technology. * **"Wallet"** refers to a cryptocurrency wallet controlled by the User used in connection with the Services. * **"Website"** means . * **"U.S. Person"** has the meaning set forth in Section 3.4. #### 2.2 Interpretation * References to clauses or sections are to those in this Agreement. * Words importing the singular include the plural and vice versa. * Headings are for convenience only and do not affect interpretation. * "Including" and similar words do not imply any limitation. ### 3. User Eligibility #### 3.1 Eligible Person By using the Service, you represent and warrant that you are an Eligible Person, meaning you: * Are at least 18 years old or of legal age to form a binding contract under applicable law. * Are not a U.S. Person, as defined in Section 3.4. * Are not a resident or citizen of any Prohibited Jurisdiction listed in Section 3.2. * Are not physically present in any Prohibited Jurisdiction. * Are not included in any trade or economic sanctions lists, including but not limited to the United Nations Security Council Sanctions List, the U.S. Treasury Department's Specially Designated Nationals List, or any other sanctions list of the United States, Canada, the United Kingdom, the European Union, Singapore, or Switzerland. * Are not a politically exposed person. * Have the legal right to use the Service and own Virtual Assets in your jurisdiction. * Are not using the Service on behalf of any third party. * Are not subject to any law or regulation that would make your participation illegal, unauthorized, or otherwise violate any applicable laws or regulations. #### 3.2 Prohibited Jurisdictions Prohibited Jurisdictions include, but are not limited to: * **United States of America**: All states of the United States, the District of Columbia; the Commonwealth of Puerto Rico; the U.S. Virgin Islands; Guam; the Commonwealth of the Northern Mariana Islands; and all other territories and possessions of the United States. * **Province of Ontario, Canada** * **People’s Republic of China** * **Afghanistan** * **Algeria** * **Bangladesh** * **Belarus** * **Bolivia** * **Cambodia** * **Central African Republic** * **Congo** * **Democratic Republic of the Congo** * **Republic of Côte d'Ivoire** * **Crimea (a region of Ukraine annexed by the Russian Federation)** * **Self-proclaimed Donetsk People’s Republic (a region of Ukraine)** * **Self-proclaimed Luhansk People’s Republic (a region of Ukraine)** * **Kherson Oblast (a region of Ukraine)** * **Zaporizhzhia Oblast (a region of Ukraine)** * **Cuba** * **Ecuador** * **Egypt** * **Eswatini** * **Gambia** * **Iran** * **Iraq** * **Liberia** * **Libya** * **Malawi** * **Mali** * **Moldova** * **Morocco** * **Myanmar** * **Nepal** * **Niger** * **North Korea** * **Pakistan** * **Palestinian Territory** * **South Sudan** * **Sudan** * **Syria** * **Venezuela** * **Vietnam** * **Yemen** * **Zambia** * **Zimbabwe** Any state, country, or other jurisdiction that is sanctioned or embargoed by the United States, United Nations, United Kingdom, European Union, or Switzerland. Any jurisdiction where it would be illegal under local law or regulation for you to hold or receive Virtual Assets, or where the distribution, sale, or purchase of Virtual Assets is prohibited or contrary to local law or regulation. #### 3.3 Politically Exposed Person A "Politically Exposed Person" refers to individuals who are or have been entrusted with prominent public functions, as well as their immediate family members and close associates. #### 3.4 U.S. Person A "U.S. Person" means: * **Individuals**: * A U.S. citizen. * A U.S. lawful permanent resident (green card holder). * An individual physically present in the United States. * An individual holding a U.S. passport. * **Entities**: * Any corporation, partnership, limited liability company, trust, or other entity organized or incorporated under the laws of the United States. * Any entity with a principal place of business in the United States. * **Trusts and Estates**: * Any trust or estate where a U.S. Person has more than 50% beneficial interest. * **Other Persons**: * Any person who is subject to U.S. taxation on worldwide income. * Any person otherwise considered a U.S. Person under Regulation S of the U.S. Securities Act of 1933. ### 4. User Representations and Warranties By accessing or using the Services, you represent and warrant that: * **Legal Capacity**: You have full legal capacity and authority to enter into these Terms. * **Authority**: If acting on behalf of an entity, you have all necessary rights and authority to bind such entity. * **Compliance with Laws**: Your use of the Services complies with all applicable laws and regulations in your jurisdiction. * **Understanding of Risks**: You understand the inherent risks associated with Virtual Assets and trading, including the risk of substantial or total loss. * **Independent Evaluation**: You have conducted your own independent investigation and analysis of the Services and Virtual Assets. * **Knowledge and Experience**: You are knowledgeable and experienced in blockchain technology, smart contracts, and Virtual Assets. * **Financial Capability**: You have sufficient investment knowledge and are capable of evaluating the merits and risks of trading in Virtual Assets. * **Decision-Making**: You are solely responsible for any decisions made using the Services. * **Legitimate Use**: You will not use the Services for any illegal activities, including money laundering, terrorist financing, or fraudulent activities. * **Ownership of Wallet**: You own and have full control over the Wallet used in connection with the Services. * **Legitimate Funds**: The funds used in connection with the Services are derived from legitimate sources. * **Sanctions Compliance**: You are not on any sanctions list or involved in any activities subject to sanctions. * **Tax Obligations**: You are responsible for determining any taxes applicable to your transactions and for reporting and remitting the correct amounts to the appropriate tax authorities. * **Professional Advice**: You have had the opportunity to seek legal, tax, accounting, and other professional advice regarding these Terms and the Services. * **Acknowledgment of No Registration**: You acknowledge that the Services are not registered with any regulatory body or securities commission, and that the Company is not registered or licensed with any regulator as an investment adviser, broker-dealer, money services business, money transmitter, or virtual currency business. * **Technological Understanding**: You have a working understanding of the usage of Virtual Assets, smart contracts, and blockchain-based software systems. * **No Reliance on Representations**: You have not relied upon any information, statement, omission, representation, or warranty, express or implied, written or oral, made by or on behalf of the Company, except as expressly set forth in these Terms. * **Data Privacy Compliance**: You agree to comply with all applicable data protection and privacy laws, including providing any necessary consents for the collection and use of your personal data as outlined in our Privacy Policy. * **Export Control Compliance**: You acknowledge that the use of the Services may be subject to international export control and economic sanctions requirements, and you agree to comply with all applicable export laws. ### 5. No Representations and Warranties by the Company Definest.ai provides the Services on an "AS IS" and "AS AVAILABLE" basis, without any representations or warranties of any kind, express or implied. We specifically disclaim: * **No Warranty of Merchantability**: We make no warranty that the Services are merchantable or fit for any particular purpose. * **No Warranty of Fitness for a Particular Purpose**: We do not warrant that the Services will meet your specific requirements. * **No Warranty of Non-Infringement**: We make no warranty that the Services do not infringe on any intellectual property rights. * **No Warranty Regarding Value or Performance**: We do not warrant the value, technical specifications, performance, or functionality of the Services. * **No Warranty of Accuracy**: We do not warrant that the Services are accurate, complete, reliable, current, or error-free. * **No Warranty Against Viruses**: We do not warrant that the Services are free of viruses or other harmful components. * **No Liability for Losses**: We expressly disclaim responsibility for any damage, loss, penalty, cost, or expense, whether direct or indirect, incidental, consequential, special, punitive, or economic, arising out of or in connection with: * **Regulatory Violations**: Your use of the Services in violation of any anti-money laundering, counter-terrorism financing, or other regulatory requirements. * **Breach of Agreement**: Your violation of any representation, warranty, obligation, covenant, or provision of these Terms. * **Unauthorized Access**: Any unauthorized data interception, interruption, transmission blackout, or delays during the delivery of the Service and placing any orders. * **Technical Failures**: Delays, failures, or errors in transmitting orders through the Services. * **Loss of Virtual Assets**: Loss of Virtual Assets due to failure to safeguard your Wallet, including loss, destruction, theft, or accidental disclosure of private keys, or not utilizing the proper type of Wallet. * **Third-Party Dependencies**: Disruptions or failures caused by third-party services, networks, or systems upon which the Services depend. * **Security Vulnerabilities**: Any security breaches, cyber attacks, or unauthorized access resulting in loss or damage. * **Regulatory Changes**: Any changes in laws or regulations that may affect the use or value of Virtual Assets or the legality of the Services. ### 6. General Use, Prohibited Use, and Termination #### 6.1 Limited License We grant you a revocable, limited, non-exclusive, non-transferable, and non-sublicensable license to access and use the Services through your internet-compatible devices for your personal and internal purposes, subject to these Terms. This license is provided solely for approved purposes as permitted by us from time to time. **No Transfer of Rights**: When you use the Services, we do not transfer any Intellectual Property Rights to you. #### 6.2 No Right to Use Except as expressly provided in these Terms, you are not granted any rights to use our Intellectual Property Rights. You agree that: * **Personal Use Only**: You may only view and use the Services, Website, Content, or User Content for your own personal use. * **No Copying or Distribution**: You may not copy, reproduce, republish, upload, repost, modify, transmit, distribute, or otherwise use the Services, Website, Content, or User Content for non-personal, public, or commercial use without our prior written consent. * **No Removal of Notices**: You may not remove or modify any copyright, trademark, or other proprietary notices placed in any part of the Website, Content, User Content, or Services. * **No Derivative Works**: You may not modify, publish, transmit, participate in the transfer or sale of, create derivative works from, or in any way exploit any of the Content or User Content. * **No Data Mining or Scraping**: You may not use any data mining, robots, or similar data-gathering or extraction methods. #### 6.3 Proprietary Rights The Services are owned and operated by Definest.ai. All materials included in the Services, including but not limited to visual interfaces, graphics, design, compilation, information, data, computer code (including source code or object code), products, software, and services are protected by intellectual property and other laws. **Ownership**: All materials are the property of Definest.ai or its third-party licensors. **Reservation of Rights**: We reserve all rights not expressly granted in these Terms. #### 6.4 User Content By submitting any User Content, you represent and warrant that: * **Rights to Content**: You are entitled to and have all necessary Intellectual Property Rights for the User Content submitted. * **No Violation of Rights**: Your User Content does not violate any third-party rights, including Intellectual Property Rights or rights to privacy. * **License to Us**: You grant us a worldwide, royalty-free, perpetual, irrevocable, non-exclusive right and license to use, reproduce, modify, adapt, publish, translate, distribute, and display such content in any media. * **Waiver of Moral Rights**: You waive any moral rights you may have in such content. **Disclosure of Identity**: We reserve the right to disclose your identity to any third party who claims that your User Content constitutes a violation of their Intellectual Property Rights or of their right to privacy. **No Compensation**: You have no right and hereby waive any request for acknowledgment or compensation based on any User Content or any modifications based on any User Content. #### 6.5 Prohibited Activities In connection with your access and use of the Services, you agree not to: * **Commercial Use**: Use the Services for resale or commercial purposes, including transactions on behalf of other persons or entities. * **Legal Violations**: Violate or assist any party in violating any law, statute, ordinance, regulation, or rule. * **Market Manipulation**: Engage in trading activities that amount to or may amount to market abuse, including pump and dump schemes, fictitious transactions, wash trading, front running, spoofing, layering, or any other manipulative or deceptive practices. * **Simultaneous Orders**: Place or accept simultaneous buy and sell orders that could potentially execute against each other. * **Fraudulent Activities**: Engage in any money laundering, terrorist financing, or fraudulent activity. * **Infringement**: Infringe upon our Intellectual Property Rights or any third party's intellectual property rights. * **System Interference**: Take any action that imposes an unreasonable or disproportionately large load on our infrastructure or detrimentally interferes with, intercepts, or expropriates any system, data, or information. * **Malware**: Transmit or upload any material that contains viruses, Trojan horses, worms, or any other harmful or deleterious programs. * **Unauthorized Access**: Attempt to gain unauthorized access to the Services or related systems. * **Automated Access**: Use any deep linking, web crawlers, bots, spiders, scripts, algorithms, or similar manual processes to access, obtain, copy, or monitor any part of the properties. * **Security Testing**: Probe, scan, or test the vulnerabilities of the Services or any network connected to the properties. * **False Information**: Provide false, inaccurate, incomplete, or misleading information when requested. * **Reverse Engineering**: Reverse engineer or disassemble any aspect of the Services in an effort to access any source code, underlying ideas, or algorithms. * **Transfer of Rights**: Transfer any rights granted to you under these Terms. * **Unacceptable Behavior**: Engage in any behavior that violates these Terms or is otherwise deemed unacceptable by us in our sole discretion. * **Circumvent Access Controls**: Attempt to circumvent any content filtering techniques or security measures we employ to restrict access to the Services or to prohibited jurisdictions. * **Unauthorized Marketing**: Use the Services for any unauthorized or unsolicited advertising, promotional materials, junk mail, spam, or any other form of solicitation. #### 6.6 Password Security; Contact Information * **Security Responsibility**: You are responsible for maintaining adequate security and control of any and all user IDs and passwords that you use to access the Services. * **Unauthorized Use**: If you suspect or become aware of any unauthorized use of your account or any other breach of security, you should notify us immediately. * **No Liability**: We assume no liability for any loss or damage arising from your failure to comply with this section or from any unauthorized access to your account. #### 6.7 Unaffiliated Third-Party Access * **Third-Party Permissions**: If you grant express permission to an unaffiliated third party to access your account or Wallet, you acknowledge that granting permission does not relieve you of any responsibilities under these Terms. * **Responsibility for Third Parties**: You are fully responsible for all acts or omissions of any unaffiliated third party with access to your account or Wallet. * **Indemnification**: You agree to indemnify us from any liability arising out of or related to any act or omission of any unaffiliated third party with access to your account or Wallet. #### 6.8 Accuracy of the Website and Related Media * **No Guarantee of Accuracy**: While we strive to provide accurate and timely information, the Content may not always be entirely accurate, complete, or current and may include technical inaccuracies or typographical errors. * **Changes without Notice**: Information may be changed or updated without notice, including information regarding our terms, policies, products, and services. * **Verification Responsibility**: You should verify all information before relying on it, and all decisions based on information contained on the Website or provided by the Services are your sole responsibility. * **Third-Party Links**: Links to third-party websites or materials are provided for convenience and do not constitute an endorsement by us. We are not responsible for the content or services of any third-party sites. #### 6.9 Termination We reserve the right, in our sole discretion, to: * **Immediate Termination**: Terminate or suspend your access to the Services immediately, without prior notice, for any reason, including violation of these Terms. * **Refusal of Service**: Refuse service to anyone for any reason. **Effect of Termination**: * **License Termination**: Your license rights will terminate, and you must immediately cease all use of the Services. * **Access Revocation**: You will no longer be authorized to access or use the Services. * **Outstanding Obligations**: Any outstanding fees or charges will become due. * **Survival of Terms**: Sections of these Terms that by their nature should survive termination will remain in effect. ### 7. Services and Fees #### 7.1 Eligibility Accessing and using the Services is intended only for Eligible Persons as defined in Section 3.1. If you are not an Eligible Person, you must not access or use the Services. If you are acting on behalf of a person that is not an Eligible Person, you must not access or use the Services. #### 7.2 Order Execution * **Execution Risks**: Due to factors such as network delays, system failures, or other force majeure events, the Services may experience delays, suspensions, or deviations. * **No Guarantee of Execution**: We use commercially reasonable efforts to ensure the Services operate effectively but do not guarantee that orders will be executed without errors or delays. * **No Liability for Execution Issues**: We are not responsible if the execution of trades does not meet your expectations due to such factors. #### 7.3 Fees * **Fee Obligation**: Accessing and using the Services may require payment of fees. You agree to pay all applicable non-refundable fees. * **Fee Disclosure**: Before you pay any fees, you will have an opportunity to review and accept the fees that will be charged. * **Types of Fees**: * **Transaction Fees**: Buying, selling, or transferring Virtual Assets through the Services may be subject to fees, commissions, royalties, and other charges, including: * **Exchange Fees**: Standard exchange service fees associated with blockchain transactions. * **Gas Fees**: Fees paid to blockchain miners for processing transactions. * **Fee Changes**: Fees may change with or without prior notice. We reserve the right to determine pricing and may update fees at any time. * **Fee Collection**: You authorize us to automatically deduct fees directly from your account or transaction amounts. * **Non-Refundable**: All fees are specified in Virtual Assets or fiat currency and are non-refundable. #### 7.4 KYC and AML Compliance * **Right to Require KYC/AML Verification**: We reserve the right to require you to complete Know Your Customer (KYC) and Anti-Money Laundering (AML) verification processes before accessing certain Services. * **Compliance Requirement**: You agree to provide all information and documentation we request for compliance purposes. * **Reporting Obligations**: We may be required to report suspicious activities to relevant authorities and comply with applicable laws and regulations. * **Refusal of Service**: Failure to complete the KYC/AML process may result in suspension or termination of your access to the Services. #### 7.5 Suspension of Services * **Right to Suspend or Terminate**: We reserve the right, in our sole discretion, to suspend or terminate the Services to specific users or all users at any time and for any reason. * **No Liability**: We are not liable for any losses or damages resulting from such suspension or termination. ### 8. General Risk Disclosures Trading Virtual Assets involves significant risk, and you should not trade more than you can afford to lose. The following list of risks associated with Virtual Assets and the Services is not exhaustive. * **Market Volatility**: Prices of Virtual Assets are highly volatile and may fluctuate dramatically over short periods. * **Regulatory Risks**: Changes in laws or regulations can affect the use or value of Virtual Assets and may impact the legality of the Services in certain jurisdictions. * **Technological Risks**: Technical issues, cyber attacks, or system failures may impact the Services and result in loss or delay. * **Operational Risks**: The Services may experience unexpected interruptions or delays due to factors beyond our control. * **Security Risks**: Despite implementing security measures, the Services may be vulnerable to hacking, malware, or other security breaches. * **Third-Party Dependencies**: The Services rely on third-party services, networks, and systems, which may experience disruptions affecting the Services. * **Legal and Compliance Risks**: You are responsible for complying with all applicable laws and regulations, and failure to do so may result in legal consequences. * **No Advice**: We do not provide investment, tax, or legal advice. You should consult your own advisors before making decisions. By using the Services, you acknowledge and accept these risks. You represent that you have been, are, and will be solely responsible for making your own independent appraisal of the risks and merits of any transaction. *** **USER ACKNOWLEDGES HAVING READ AND UNDERSTOOD THESE TERMS AND AGREES TO BE BOUND BY ALL OF THE TERMS AND CONDITIONS HEREOF.**