Docs/Sell and trade points/Marketplaces

Marketplaces

Buy and sell points through escrowed offers, with partial fills and fees paid in USD.

Listings#

Wallets and marketplaces can display points, program artwork, and expiry dates.

Program metadata includes name, description, artwork, issuer, loyalty ID, and expiry attributes. Customers can use compatible secondary markets to discover or trade reward balances.

Loyfin Markets#

Open Market beside a balance in your Loyalty Wallet to buy or sell that program’s points. Sell offers lock the listed points. Buy offers lock the offered USD. Other customers can fill all or part of an offer; cancelling returns its remaining escrow.

Each offer covers one point expiry date. After point expiry, new offers and fills are blocked. A buy-offer maker can still cancel and recover the remaining USD. A sell-offer maker must cancel before point expiry to recover unfilled points; expired points cannot be transferred back. An earlier offer deadline ends trading but does not by itself prevent cancellation. Legacy programs with transfer restrictions can also block returning sell escrow.

Each fill charges the taker 0.1 USD plus an initial 1% of the filled USD value, split 50/50 between the issuer and Loyfin. Buyers pay fees on top; sellers receive proceeds less fees. Every partial fill incurs its own flat fee. The current percentage is shown before confirmation; network fees are additional.

The public order book is available at GET /markets/{chainId}/{token}. Creation, filling and cancellation are transactions on LoyfinMarkets. OfferCreated, OfferFilled and OfferCancelled are indexed separately for that contract. They do not trigger issuance or redemption webhooks to brands.

Other marketplaces#

Marketplace royalties are configured at the program level. Royalty deposits held by the program are withdrawn with a brand receiver and protocol split.