Developer fees

Get developer fee balance

Check your accumulated developer fee balance.

GET
/api/v2/developer-fees

Returns your organization's current developer fee balance. This balance accumulates from fees charged on customer deposits and can be claimed to your organization's wallet. All three amounts read "0" until your organization's wallet is configured for claiming, even if fees have accrued.

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key obtained on Settings > API Keys page in Compose UI.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET 'https://compose.finance/api/v2/developer-fees' \  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "balance": "1250.5",
  "pendingClaims": "0",
  "availableBalance": "1250.5",
  "currencyId": "usdc_base",
  "currency": "usdc"
}

{
  "error": "Unauthorized - Invalid or missing API key or session"
}
{
  "error": "Customers feature is not enabled for your organization"
}
{
  "error": "Rate limit exceeded. Please try again later."
}

{
  "error": "Internal server error"
}

Get customer developer fees GET

Returns the current developer fee configuration for the customer. Developer fees are charged by your organization on customer transactions and accumulate in your developer fee balance.

Update customer developer fees PATCH

Updates the developer fee configuration for the customer. These fees are deducted from customer deposits before USDC is sent to their wallet. **Fee Types** - `developerSpreadFeeBps`: Spread fee in basis points (0-2500, max 25%). Applied to the USDC amount. **Fee Calculation** ``` spreadFee = amount × spreadFeeBps / 10000 customerReceives = amount - spreadFee ``` **Example:** 1000 USDC deposit with 1% spread (100 bps) → customer receives 990 USDC