🧩 Builder Fees

Builder Fees let approved apps, wallets, bots, terminals, and trading interfaces earn a configured rebate from trading activity attributed to their products on Storm Trade.

Storm uses a registered revenue-share model. The builder's rebate rate and any builder-specific trader discount are configured during onboarding for a specific TON address. The integration then sends that address with each V3 order request.

🎯 Who It Is For

Builder Fees are designed for products that bring trading activity to Storm, including:

• Trading terminals and alternative interfaces
• Telegram bots and mini apps
• Wallets with embedded perpetual trading
• Automated strategies and portfolio tools

✨ Benefits

Earn on Routed Trades

Receive a configured rebate from discounted Trading Fees and eligible liquidation penalties generated by attributed positions.

Transparent and Flexible

Your raw rebate rate, active status, and cumulative earnings are available through the builder registry API. Revenue-share terms and an optional builder-specific trader discount are configured for your integration, while your client only needs to identify the registered builder address.

Automatic Payouts

Builder earnings are credited automatically to the Storm Smart Account associated with the registered TON address. No separate claim transaction is required.

🧮 Fee Model

Storm keeps the Trading Fee and Execution Fee separate:

• Trading Fee is the position fee charged when opening or closing a position.
• Execution Fee is a separate charge when an executor processes the order. It is not part of the builder rebate base.
• Trader discount reduces the Trading Fee rate. A builder-specific discount is combined with any other applicable trader discounts before the Trading Fee is calculated.
• Builder rebate is calculated from the resulting Trading Fee after the trader discount has been applied. It is not calculated from the Execution Fee.

The effective Trading Fee rate is:

effective Trading Fee rate = base Trading Fee rate × (1 - combined trader discount)

For a liquidation without bad debt, the builder rebate is also calculated from the liquidation penalty. The trader discount does not reduce the liquidation penalty. Funding and rollover fees are not included in either the builder rebate or trader discount base.

Raw Rate Scaling

The rebate value returned by GET /builders is a raw fixed-point integer. Convert it as follows:

fraction = raw value / 1,000,000,000
percent  = raw value / 10,000,000
bps      = raw value / 100,000

🔄 How It Works

1. Submit a builder application.
2. The Storm team contacts you on Telegram to review the integration, agree the commercial terms, and register your TON address.
3. Add the registered address as the top-level builder field when submitting V3 orders.
4. When an attributed position generates a Trading Fee or an eligible liquidation penalty, Storm applies the registered rebate and credits the builder automatically.

Only registered and active builders receive a rebate. An omitted, malformed, inactive, or unregistered builder address does not block the order; it is processed without builder attribution.

🔌 Add Builder Attribution

Send the builder address in the outer request body for POST /order/place:

{
  "sa": "<smart-account-address>",
  "message": "<base64-encoded-user-intent>",
  "public_key": "<base64-encoded-public-key>",
  "signature": "<base64-encoded-signature>",
  "builder": "<registered-TON-address>"
}

The message, public_key, and signature fields keep the existing signed-intent flow. Builder attribution is optional request metadata and is not part of the signed intent.

Both raw (0:<64-hex-characters>) and user-friendly (EQ... or UQ...) TON address formats are accepted. Always use the exact address registered during onboarding.

API Environments

📊 Check Registration and Earnings

Use GET /builders to inspect registered builders:

curl https://api.storm.tg/v3-node-0/builders

Example response:

[
  {
    "builder": "0:<64-hex-characters>",
    "rebate": 500000,
    "fee_earned": "1250000000",
    "active": true,
    "created_at": 1788278400000,
    "updated_at": 1788278400000
  }
]

In this example, rebate: 500000 means 0.05%, or 5 bps.

🚀 Apply

Ready to build on Storm? Submit your application. The team will follow up on Telegram with integration details and next steps.

For the complete request and response schemas, see the Storm V3 API documentation.