Skip to navigation
Partner operations

Partner fees

Your partner fee schedule is a set of tiers on your partner’s escrow. You draft the tiers through the API, then publish them on chain with your manager wallet.

Read the current fees

GET /v1/partner/fees returns the active on-chain rules and your saved draft tiers separately.

Save a schedule

Save a draft with PUT /v1/partner/fees/draft. The final tier must cover 50,000 USD. Each tier applies to the whole principal, not to progressive slices. Values are in basis points or USD, as the endpoint page documents. upperUsd and FLAT_USD amounts allow at most six decimal places, and more returns 400 VALIDATION_ERROR.

Publish through the manager wallet

POST /v1/partner/fees/publish returns an unsigned transaction. Connect your registered manager wallet, sign the transaction, send it and pay its gas. Treat the draft as active only after you see a confirmed receipt and GET /v1/partner/fees shows the new tiers under active.