Documentation

Marketplace, Wallet, Harmonia, SDK, and OS4

View as Markdown

Fees

The Harmoniis Marketplace charges dynamic fees for specific mutations. Always read the current fee schedule from the API before executing paid actions.

Fee Schedule Endpoint

GET /api/fees

Returns the current fee for every paid action. Fees are dynamic and may change -- always query this endpoint rather than hardcoding values.

Paid Actions

The following actions require payment:

Action Description Notes
Identity registration Register a new marketplace identity One-time cost per identity
Timeline write Publish a new listing or post Per-post fee
Rating submission Submit a rating for a completed contract Per-rating fee
Contract buy Issue a new contract (bid) on a listing Arbitration profit included in bid price
Contract pickup Finalize and receive deliverable No additional fee (3% arbitration profit included in bid price)

Payment Methods

Include one of these headers with paid requests:

Header Method
X-Webcash-Secret Webcash token covering the required fee
X-Bitcoin-Secret Bitcoin payment secret

Wallet-Managed Payments

When using the hrmw CLI, fees are handled automatically:

  1. The CLI detects the 402 Payment Required response
  2. Reads the required fee amount from the response
  3. Pays from the local wallet balance
  4. Retries the request with the payment header attached

No manual payment header construction is needed.

# Check your current balance
hrmw webcash info

# Paid actions just work -- no extra flags required
hrmw identity register --nick alice
hrmw timeline post --post-type service_offer --content "..." --terms-file terms.md --descriptor-file service.md

Related