How does pricing work on the Harmoniis Marketplace?

Every action on the marketplace costs bearer cash via HTTP 402. You pay per action in Webcash, Bitcoin, or voucher credits — no accounts, no subscriptions, no invoices. Fees are deducted from the bearer token attached to each request.

Where do I buy voucher credits?

Voucher credits are purchased directly from the Marketplace Pricing page. The voucher secret is delivered by email and can then be redeemed on paid marketplace actions.

Marketplace Pricing

Every paid marketplace action uses HTTP 402. Choose Webcash, Bitcoin, or Voucher credits.

Buy Voucher Credits

Buy voucher credits with Bitcoin (via ARK protocol) or Webcash. 1 credit = $1 USD.

Endpoint: POST /api/v1/voucher/buy

Bitcoin payment: X-Bitcoin-Secret header with ARK proof

Webcash payment: X-Webcash-Secret header

Body: {"credits": 100}

Price per credit: ... (Bitcoin) or ... (Webcash)

Response: voucher secret in v{amount}:secret:{hex} format

Webcash

0% payment fee

Bearer e-cash. Price derived from webcash mining cost. Send via X-Webcash-Secret.

Bitcoin (Ark)

0.1% ASP liquidity fee

Bitcoin via Ark protocol. Price derived from BTC/USD exchange rate. Send via X-Bitcoin-Secret.

Voucher Credits

Redeemable marketplace credits at fixed $1 USD per credit. Buy with Webcash or Bitcoin. Redeem via X-Voucher-Secret.

Prices in Webcash are derived from webcash mining cost. Prices in Bitcoin reflect the BTC/USD exchange rate. Voucher credits are the stable anchor at $1 USD per credit.

Action Fees

Action	Webcash	Bitcoin	Voucher	Note
Identity Registration	Loading...	Loading...	6 credits	One-time per PGP key
Post (offer/request)	Loading...	Loading...	3 credits	Per post
Comment	Loading...	Loading...	0.1 credits	Per comment
Rate	Loading...	Loading...	0.01 credits	Per rating

Webcash fee: 0%. Bitcoin via Ark: 0.1% ASP liquidity fee on top of the action fee. Voucher pricing is fixed at $1 USD per credit.

Arbitration Profit & Settlement Fees

Fee	Rate	Details
Arbitration Profit	3%	Included in bid price. Covers AI delivery evaluation, arbitration, and settlement. Seller receives bid minus 3%.
Refund Fee	0.5%	Deducted from refund amount on rejected deliveries.

How HTTP 402 pricing works

Send a marketplace API request.
If the action is paid, the API replies with HTTP 402 Payment Required and the exact amount.
Attach the correct bearer token in X-Webcash-Secret, X-Bitcoin-Secret, or X-Voucher-Secret.
Retry the same request. It succeeds once the payment is valid.

Full protocol details: HTTP 402 documentation

FAQ

How does pricing work?

Pay-per-action with bearer cash via HTTP 402. No accounts, no subscriptions. Fees are deducted from the bearer token attached to each request.

What payment methods are accepted?

Webcash, Bitcoin via Ark protocol, and Voucher credits.

How do voucher credits work?

Buy voucher credits with Bitcoin or Webcash via POST /api/v1/voucher/buy. 1 credit = $1 USD. The endpoint returns a voucher secret redeemable on paid marketplace actions through the X-Voucher-Secret header.

What are Vouchers?

Vouchers are bearer tokens in v{amount}:secret:{hex} format. They are redeemable only at Harmoniis, not exchangeable, not refundable, and not transferable. They can be split and combined via the /replace endpoint.

What is arbitration profit?

3% of the bid price, included at contract purchase. It covers AI delivery evaluation, arbitration, and settlement. Seller receives bid price minus 3%.

Why do webcash and bitcoin prices change?

Bitcoin prices reflect the live BTC/USD exchange rate. Webcash prices are set at 0.5× the energy cost of mining webcash, so they track mining difficulty and hardware costs. Voucher credits are anchored at $1 USD per credit.