All Collections
3Commas API for Developers and 3Commas Apps
3Commas Apps
3Commas Apps Documentation
3Commas Apps Documentation

Welcome to the 3Commas Apps Developer guide! Here you may find answers to the most frequently asked questions.

Updated over a week ago

Technical Details

All apps are shown via Frames. That means you have to host your web application on your side, allowing it to be shown in frames. Due to Frames' nature, not all products, such as Twitter and Telegram, allow working with them. Hence, please test your app functionality before applying to the store.

When a user launches an app, a unique API key with requested permissions is created and sent to your side. So a user no longer has to provide you API keys manually.

API Details

When a user launches an App, we send an API key with additional information. This information contains:

  • API

  • Secret key

  • Hashed user ID

  • Hashed email (lowercase, SHA 256)

  • Theme parameters (night or day)

An example of a request being sent looks like this:

https://grinazarko.github.io/?api_key=dec1a01423ca4b5d9cc4abdc7216479f6fbb3dc731f843a69da1508d09690381&secret=0c23f7d50646f471d0d4d3685356774af142868ca7a56957337afcfe36ce1a141d8004c8258004e45b28744b124c73496db047cc35533a3ca1652587354d937ca938009ad6493c673bc20dc8af0da334ec5ef67b56054dd2e08d0fcf02f4438bf970dfcb&user_id=c6979b96b62bed6d1d44ec036cb618104594a423e3fe7fac54e8cb0c0a1cf205&user_email=ecae38d5e11e3830c697c7eb33eabef1d429099d86ab312b6220ff643bf16be4?is_night_theme=false

How to add an app

  1. Go to the Apps Store page.

  2. Click to Upload an app

  3. Fill in a short form

    1. App name

    2. Short description

    3. Main description (works with https://remarkjs.github.io/react-markdown/, so you can make it look smooth and stylish)

    4. Icon

    5. Tags

    6. 3 Screenshots

  4. Select Permissions (an API key with requested permissions will be created. Please note that most developers can create only Temporary write access permission. This was made due to security issues. It means write API keys will be active ONLY if a user has your app launched. When users close your app, API keys will stop working in 60 seconds. However, the same API keys will be active once the user relaunches your app. To request permanent keys, please message the 3Commas support team.

  5. Click the “Release” button on your app.

After that, your app will be sent to moderation. The process can take up to 1-2 business days. Your previous version keeps being active.

Monetization and billing

The terms for your app monetization are described in 3Commas API Terms of Use for Developers (section 9).

3Commas Developers Community

Do not hesitate to join our 3Commas Apps Development Telegram chat for the latest updates!

Did this answer your question?