KindMind's routing engine is available to external platforms and communities through a B2B API.
Two partner programs define access, payouts, and charity participation.
Overview
| Program | Best for | Integration | Max reward | Charity allocation | Frontend | Support | Payout |
|---|---|---|---|---|---|---|---|
| Program 1 API Integrator | Wallets, DEX frontends, trading platforms | Self-serve API key | Up to 5% USDT rebate | 7.5% of gross fees | Partner builds UI | Docs, SDK, Swagger | Monthly in USDT on Solana |
| Program 2 Community Partner | Trading communities, influencer groups, DAOs | Managed by KindWorld | Up to 15% USDT revenue share | 10% of gross fees | White-label swap card | Dedicated frontend and backend support | Monthly in USDT on Solana |
Program 1 — API integrator program
This program fits wallets, DEX aggregator frontends, portfolio tools, and DeFi dashboards.
It gives partners best-route swap execution without building routing infrastructure.
How it works
- Apply and agree The partner applies through the KindMind partner portal. A fixed integrator fee is agreed at onboarding.
- API key issued KindWorld issues an API key for the partner environment. SDK access, Swagger docs, and webhook setup are provided.
- Volume tracked Monthly swap volume is tracked in real time against the partner API key.
- Rebate paid monthly The partner receives the rebate tied to the volume tier reached. Payouts are made monthly in USDT on Solana.
Fee and reward structure
| Component | Description | Rate | Recipient |
|---|---|---|---|
| Integrator fee | Fixed fee per swap routed through KindMind | Fixed at agreement time | KindWorld |
| Volume rebate | Monthly USDT rebate based on volume tier | Up to 5% | Partner wallet |
| Charity allocation | Calculated on gross fees before rebate | 7.5% gross | Partner's nominated charity |
The rebate and charity allocation are not additive from the partner's cost perspective.
Both are funded from KindWorld's gross fee earnings.
The partner pays the fixed integrator fee only.
5-tier volume structure
Volume thresholds are still being finalised.
Tier names and rebate percentages are confirmed.
Thresholds will be published here after market research is complete.
| Tier | Name | Monthly volume | USDT rebate | Charity allocation | Payout |
|---|---|---|---|---|---|
| 1 | Starter | TBD | 1% | 7.5% gross | Monthly |
| 2 | Growth | TBD | 2% | 7.5% gross | Monthly |
| 3 | Scale | TBD | 3% | 7.5% gross | Monthly |
| 4 | Pro | TBD | 4% | 7.5% gross | Monthly |
| 5 | Elite | TBD | 5% | 7.5% gross | Monthly |
Tier assignment is based on the previous calendar month's total routed volume.
Partners are notified of tier changes at the start of each new month.
What API integrators get
- Lower net API cost as routed volume grows.
- Better execution quality with less slippage.
- A charity story partners can share publicly.
- Charity nomination rights for the 7.5% allocation.
- Predictable monthly USDT payouts on Solana.
Program 2 — Community partner program
This program fits trading communities, influencer groups, and Web3 organisations.
KindWorld handles the full stack.
The community does not need a developer.
How it works
- Apply and onboard The community applies through the KindMind partner portal. KindWorld captures branding and deployment requirements.
- Swap card built KindWorld builds a white-label swap card. It is configured to the community brand.
- Embed and go live The swap card is deployed to the community website, app, or supported platform. Volume tracking starts from the first live swap.
- Revenue paid monthly The community receives revenue share based on the tier reached. Charity allocations are sent to the nominated charity.
Revenue and reward structure
| Component | Description | Rate | Recipient |
|---|---|---|---|
| Revenue share | Monthly share of gross fees from community swap volume | Up to 15% | Community wallet |
| White-label swap card | Branded swap UI with community name, logo, and colours | Included | Community brand |
| Dedicated dev support | Frontend and backend integration support | Included | Community |
| Charity allocation | Share of gross fees directed to the nominated charity | 10% gross | Community's nominated charity |
5-tier volume structure
Community Partner thresholds are separate from Program 1.
They reflect higher, community-scale trading activity.
Thresholds will be published here after market research is complete.
| Tier | Name | Monthly volume | Revenue share | Charity allocation | Payout |
|---|---|---|---|---|---|
| 1 | Entry | TBD | 3% | 10% gross | Monthly |
| 3 | Growth | TBD | 9% | 10% gross | Monthly |
| 4 | Premium | TBD | 12% | 10% gross | Monthly |
| 2 | Active | TBD | 6% | 10% gross | Monthly |
| 5 | Elite | TBD | 15% | 10% gross | Monthly |
Revenue share scales from Tier 1 to Tier 5.
The 10% charity allocation applies from day one.
It does not depend on tier progression.
What community partners get
- Passive USDT revenue from existing community trading activity.
- No technical build or maintenance burden.
- Full community branding on the swap experience.
- Charity nomination rights tied to the community identity.
- A monthly payout model that grows with swap volume.
White-label swap card
The white-label swap card is available only to Community Partner program participants.
It is powered by the KindMind routing engine.
Technical specification
| Feature | Detail |
|---|---|
| Branding | Fully white-labelled with community name, logo, and colour palette |
| Embed method | iframe embed or React component |
| Maintenance | Ongoing updates and support handled by KindWorld |
| Routing engine | Best-route, MEV-protected, low-slippage execution on Solana |
| Volume tracking | All volume attributed to the community API key |
| Wallet support | Phantom, Solflare, Backpack, and Privy |
| Fee collection | Fee collection handled atomically with ATA guard protection |
| Dashboard | Real-time volume, payout accrual, and charity tracking |
Managed integration scope
KindWorld handles the following work for community partners:
- Branding intake for logo, colours, and font preferences.
- Frontend customisation and backend setup.
- Embed deployment, QA, and mainnet testing.
- Ongoing maintenance after launch.
Charity mechanism
How Impact-Fi disbursement works
Swap executed → Gross fee collected → Charity % ring-fenced → KindSoul disburses
- A user executes a swap through the partner interface or swap card.
- The gross fee is collected at swap execution.
- The charity allocation is ring-fenced in the KindWorld charity reserve wallet.
- KindWorld or KindSoul disburses the accrued funds to the nominated charity.
Governance rules
- Partners nominate a charity during onboarding.
- KindWorld may verify charity legitimacy before approval.
- Disbursements run monthly alongside rebates and revenue share payouts.
- A contribution receipt or on-chain reference is provided each month.
- Partners can change the nominated charity with 30 days' written notice.
- Charity funds are never commingled with operational funds.
- Charity funds never pass through the partner or community.
Partners receive the charitable association and nomination rights at no added cost.
The 7.5% and 10% charity allocations come from KindWorld's gross fee earnings.
They do not reduce the partner rebate or add extra charges.
API technical reference
Authentication
All API requests require a valid API key issued during onboarding.
Pass the key in the request headers:
Authorization: Bearer <YOUR_KINDMIND_API_KEY>
X-Partner-ID: <YOUR_PARTNER_ID>Base URL
https://api.kindmind.world/v1API endpoints, full Swagger documentation, and the partner SDK will be published here at launch.
Volume thresholds will be added once finalised.
Core endpoints
GET /quote
Returns the optimal route and estimated output for a swap.
GET /v1/quote?inputMint={TOKEN_ADDRESS}&outputMint={TOKEN_ADDRESS}&amount={LAMPORTS}&slippageBps={BPS}Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
inputMint | string | Yes | Solana mint address for the input token |
outputMint | string | Yes | Solana mint address for the output token |
amount | number | Yes | Input amount in lamports |
slippageBps | number | No | Slippage tolerance in basis points. Default is 50 |
onlyDirectRoutes | boolean | No | Restrict to single-hop routes. Default is false |
Example response
{
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inAmount": "1000000000",
"outAmount": "142850000",
"priceImpactPct": "0.012",
"routePlan": [
{
"swapInfo": {
"ammKey": "...",
"label": "Raydium CLMM",
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inAmount": "1000000000",
"outAmount": "142850000",
"feeAmount": "2500000",
"feeMint": "So11111111111111111111111111111111111111112"
},
"percent": 100
}
],
"contextSlot": 285123456,
"timeTaken": 0.021
}POST /swap
Returns a serialised Solana transaction for the quoted route.
The partner frontend signs and submits the transaction.
POST /v1/swap
Content-Type: application/jsonRequest body
{
"quoteResponse": {},
"userPublicKey": "USER_WALLET_PUBLIC_KEY",
"wrapAndUnwrapSol": true,
"computeUnitPriceMicroLamports": 5000,
"asLegacyTransaction": false
}Fields
| Field | Type | Required | Description |
|---|---|---|---|
computeUnitPriceMicroLamports | number | No | Priority fee in micro-lamports |
asLegacyTransaction | boolean | No | Use legacy transaction format. Default is false |
quoteResponse | object | Yes | Full quote object returned from GET /quote |
wrapAndUnwrapSol | boolean | No | Auto wrap or unwrap native SOL. Default is true |
userPublicKey | string | Yes | User's Solana wallet public key |
Example response
{
"swapTransaction": "BASE64_ENCODED_TRANSACTION",
"lastValidBlockHeight": 285123999,
"prioritizationFeeLamports": 5000
}GET /tokens
Returns the list of tokens supported by the KindMind routing engine.
GET /v1/tokensGET /partner/stats
Returns volume, rebate accrual, and charity contribution data for the authenticated partner.
GET /v1/partner/stats?period=2025-05Example response
{
"partnerId": "kw_partner_abc123",
"period": "2025-05",
"totalVolumeUSD": 4250000.0,
"currentTier": 3,
"tierName": "Scale",
"rebateRatePct": 3.0,
"rebateAccruedUSDT": 1275.0,
"charityRatePct": 7.5,
"charityAccruedUSDT": 3187.5,
"nominatedCharity": "GiveDirectly",
"payoutDate": "2025-06-01",
"payoutWallet": "PARTNER_SOLANA_WALLET_ADDRESS"
}ATA guard and fee collection safety
KindMind uses an ATA guard to prevent silent fee collection failures on Solana.
When fees are collected in non-SOL tokens, the fee wallet must have an associated token account for the incoming token.
KindMind handles this automatically by bundling createAssociatedTokenAccountIdempotent into the swap transaction.
No partner action is required.
MEV protection
All swaps routed through KindMind use Jito bundle integration by default.
This provides:
- Protection against front-running.
- Atomic execution for bundled transactions.
- Priority fee optimisation through QuickNode Priority Fees API.
Webhook callbacks
Partners can register a webhook URL during onboarding.
POST https://your-partner-endpoint.com/webhook
Content-Type: application/json
X-KindMind-Signature: HMAC_SHA256_SIGNATUREPayload example
{
"event": "swap.completed",
"partnerId": "kw_partner_abc123",
"txSignature": "SOLANA_TX_SIGNATURE",
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inAmountLamports": "1000000000",
"outAmountLamports": "142850000",
"feeLamports": "2500000",
"timestamp": "2025-05-01T14:23:00Z",
"volumeUSD": 142.85
}Validate X-KindMind-Signature with HMAC-SHA256 and your partner secret.
Applying to the program
API Integrator Program
- Submit an application through the KindMind Partner Portal.
- Agree on API terms and the fixed integrator fee.
- Receive API credentials.
- Start integration with the SDK and Swagger docs.
Community Partner Program
- Submit an application through the KindMind Partner Portal.
- Confirm revenue share terms and charity nomination.
- Complete branding intake.
- KindWorld builds and deploys the white-label swap card.
- Volume tracking starts from the first live swap.
Community Partner capacity is limited.
KindWorld controls onboarding volume to maintain deployment quality.
Frequently asked questions
When are rebates and revenue share paid?
Payouts are made at the end of each calendar month.
They are sent in USDT on Solana to the nominated wallet.
What happens if volume drops mid-month?
Tier assignment is based on total monthly volume at month end.
Intra-month changes do not affect the current month's payout calculation.
Does the charity allocation reduce the rebate or revenue share?
No.
The charity allocation is funded from KindWorld gross fee earnings.
It is separate from partner payouts.
Can a partner change its nominated charity?
Yes. It takes effect at the start of the following calendar month.
Do charity funds pass through the partner or community?
No. KindWorld and KindSoul disburse funds directly.
Is there a minimum volume requirement for Program 1?
No minimum is required to join.
Tier-based rebates begin once the first threshold is reached.
Does a Community Partner need a developer?
No. KindWorld provides dedicated frontend and backend support for the full integration.
What stablecoin is used for payouts?
All payouts are made in USDT on Solana.
Is KindMind custodial?
No. KindMind is non-custodial.
User funds remain in user wallets and settle on-chain.
