Polysia

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,0002.0 %
≤ 300,0001.5 %
≤ 600,0001.0 %
≤ 900,0000.5 %
above0.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"