Monetization & Charge Fees

As an integrator, you can monetize Blackhole and collect fees from our SDK/API integration.

Any dApp that integrates Blackhole’s SDK or API can charge a fee on every transaction volume it processes through Blackhole.

---

How it works

When using the Blackhole SDK or calling our API to request quotes, you can include a fee parameter that defines how much you want to charge.

Blackhole uses basis points (bps) for fees:

• 1 bps = 0.01%

• Example: 20 bps = 0.2%

Add two parameters to your request:

• integrator — your unique identifier

• feeBps — fee amount in bps (e.g. 20 for 0.2%)

Blackhole calculates and deducts the fee automatically and shows it in the returned quote and final minOut.

---

EVM

• Fees accumulate in the Blackhole fee collector contract.

• Only the wallet you register for fee collection can claim these funds.

• Fees already accrued remain tied to the wallet that earned them.

• If you change the fee-collection wallet, only future fees will be routed to the new wallet.

---

Sui

• Fees are transferred directly to the fee wallet you specify.

• No claiming or further action is required.

---

Solana

• Fees are transferred directly to the fee wallet you specify.

• No claiming or further action is required.

---

How to set up fee wallets

To start collecting fees:

1. Register your integration and provide fee-collection wallets for each chain.

2. Fees are collected per chain and per token.

3. Our dashboard provides an overview of collected fees and can generate the transaction data required to withdraw them on EVM.

---

How to set up fee collection

1. The feeBps parameter is the fee amount taken from each transaction. Use an integer value (e.g. 20 for 0.2%).

2. The maximum allowed fee is less than 500 bps (5%).

3. Always pass your integrator string so the system can correctly attribute and distribute the fees.

Blackhole may charge a small protocol execution fee depending on volume and integration type. This is always shown separately in the quote.