KindWorld
Back to Docs

KindSwap Partnership Program

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

ProgramBest forIntegrationMax rewardCharity allocationFrontendSupportPayout
Program 1 API IntegratorWallets, DEX frontends, trading platformsSelf-serve API keyUp to 5% USDT rebate7.5% of gross feesPartner builds UIDocs, SDK, SwaggerMonthly in USDT on Solana
Program 2 Community PartnerTrading communities, influencer groups, DAOsManaged by KindWorldUp to 15% USDT revenue share10% of gross feesWhite-label swap cardDedicated frontend and backend supportMonthly 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

  1. Apply and agree The partner applies through the KindMind partner portal. A fixed integrator fee is agreed at onboarding.
  2. API key issued KindWorld issues an API key for the partner environment. SDK access, Swagger docs, and webhook setup are provided.
  3. Volume tracked Monthly swap volume is tracked in real time against the partner API key.
  4. 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

ComponentDescriptionRateRecipient
Integrator feeFixed fee per swap routed through KindMindFixed at agreement timeKindWorld
Volume rebateMonthly USDT rebate based on volume tierUp to 5%Partner wallet
Charity allocationCalculated on gross fees before rebate7.5% grossPartner'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.

TierNameMonthly volumeUSDT rebateCharity allocationPayout
1StarterTBD1%7.5% grossMonthly
2GrowthTBD2%7.5% grossMonthly
3ScaleTBD3%7.5% grossMonthly
4ProTBD4%7.5% grossMonthly
5EliteTBD5%7.5% grossMonthly

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

  1. Apply and onboard The community applies through the KindMind partner portal. KindWorld captures branding and deployment requirements.
  2. Swap card built KindWorld builds a white-label swap card. It is configured to the community brand.
  3. 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.
  4. 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

ComponentDescriptionRateRecipient
Revenue shareMonthly share of gross fees from community swap volumeUp to 15%Community wallet
White-label swap cardBranded swap UI with community name, logo, and coloursIncludedCommunity brand
Dedicated dev supportFrontend and backend integration supportIncludedCommunity
Charity allocationShare of gross fees directed to the nominated charity10% grossCommunity'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.

TierNameMonthly volumeRevenue shareCharity allocationPayout
1EntryTBD3%10% grossMonthly
3GrowthTBD9%10% grossMonthly
4PremiumTBD12%10% grossMonthly
2ActiveTBD6%10% grossMonthly
5EliteTBD15%10% grossMonthly

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

FeatureDetail
BrandingFully white-labelled with community name, logo, and colour palette
Embed methodiframe embed or React component
MaintenanceOngoing updates and support handled by KindWorld
Routing engineBest-route, MEV-protected, low-slippage execution on Solana
Volume trackingAll volume attributed to the community API key
Wallet supportPhantom, Solflare, Backpack, and Privy
Fee collectionFee collection handled atomically with ATA guard protection
DashboardReal-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

  1. A user executes a swap through the partner interface or swap card.
  2. The gross fee is collected at swap execution.
  3. The charity allocation is ring-fenced in the KindWorld charity reserve wallet.
  4. 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/v1

API 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

ParameterTypeRequiredDescription
inputMintstringYesSolana mint address for the input token
outputMintstringYesSolana mint address for the output token
amountnumberYesInput amount in lamports
slippageBpsnumberNoSlippage tolerance in basis points. Default is 50
onlyDirectRoutesbooleanNoRestrict 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/json

Request body

{
  "quoteResponse": {},
  "userPublicKey": "USER_WALLET_PUBLIC_KEY",
  "wrapAndUnwrapSol": true,
  "computeUnitPriceMicroLamports": 5000,
  "asLegacyTransaction": false
}

Fields

FieldTypeRequiredDescription
computeUnitPriceMicroLamportsnumberNoPriority fee in micro-lamports
asLegacyTransactionbooleanNoUse legacy transaction format. Default is false
quoteResponseobjectYesFull quote object returned from GET /quote
wrapAndUnwrapSolbooleanNoAuto wrap or unwrap native SOL. Default is true
userPublicKeystringYesUser'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/tokens

GET /partner/stats

Returns volume, rebate accrual, and charity contribution data for the authenticated partner.

GET /v1/partner/stats?period=2025-05

Example 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_SIGNATURE

Payload 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

  1. Submit an application through the KindMind Partner Portal.
  2. Agree on API terms and the fixed integrator fee.
  3. Receive API credentials.
  4. Start integration with the SDK and Swagger docs.

Community Partner Program

  1. Submit an application through the KindMind Partner Portal.
  2. Confirm revenue share terms and charity nomination.
  3. Complete branding intake.
  4. KindWorld builds and deploys the white-label swap card.
  5. 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.