Fees and business info
How fees work
The platform fee is taken on-chain inside every sweep (from your invoice/customer addresses to your Hot Wallet); you never pay an invoice. The rate is marginal per business per fixed 30-day fee period (periods are counted from 1970-01-01 UTC, not calendar months) and depends on the volume swept in that period:
| period volume (USDT) | rate |
|---|---|
| ≤ 150,000 | 2.0 % |
| ≤ 300,000 | 1.5 % |
| ≤ 600,000 | 1.0 % |
| ≤ 900,000 | 0.5 % |
| above | 0.3 % |
Plus your operator's share (operator multiplier, see /v1/fees). A deposit counts in the period in which it is swept, not received.
GET /v1/fees (scope business:read)
Reads the factory contract (cached 30 s; 503 chain_unavailable if the RPC fails):
{"object":"fees","fee_period":{"period":692,"start":"…","end":"…","swept_volume":"3.000000","polysia_fee":"0.060000",
"next_rate_percent":"2","tiers":[…],"note":"…"},"operator_multiplier_percent":"50","pending_multiplier":null,
"unswept":{"amount":"1.000000","estimated_polysia_fee":"0.020000","estimated_operator_fee":"0.010000","estimate":true}}
GET /v1/fees/quote?amount=250 (scope business:read)
Estimate for one more sweep of amount now (estimated_polysia_fee, estimated_operator_fee, estimated_net). The real fee depends on everything swept before it in the same period.
GET /v1/business (scope business:read)
Business name and on-chain id, network, chain_id, factory, token, Hot Wallet (active / pending), on-chain owner status, and invoice_settings (min_amount, max_amount, expiry_default_seconds, tolerances) — read the limits here before creating invoices.
curl -sS "$API/v1/business" -H "Authorization: Bearer $POLYSIA_API_KEY"