FidMarket Documentation
A practical guide for buying, selling, making offers, managing authorizations, and completing Farcaster FID transactions on FidMarket.
Overview
FidMarket is a marketplace for buying and selling Farcaster FIDs. It coordinates wallet authentication, payment, Farcaster transfer authorizations, and settlement so buyers and sellers can complete a trade from one place.
Listings are designed to be low-friction for sellers. A seller can keep control of the Farcaster account while it is listed, and the FID is transferred only when a transaction reaches settlement.
Network
Wallet-first
Escrow-backed
Getting Started
For Buyers
- Browse FIDs currently listed for sale
- Buy a listing immediately with Buy Now
- Make a funded WETH offer where available
- Choose the recovery address for the acquired FID
- Track payment, authorization, and settlement progress
- Receive in-app and optional Telegram updates
You will need:
- A compatible Ethereum wallet
- ETH or WETH on Optimism depending on the transaction
- A recovery address for the FID you are acquiring
For Sellers
- List an eligible Farcaster FID for sale
- Choose the listing price and available sale options
- Continue using the account while the listing is active
- Review and accept eligible funded offers
- Sign the final transfer authorization when required
- Track the sale until settlement is complete
You will need:
- The wallet that currently controls the FID
- A valid Farcaster transfer authorization when requested
- Enough ETH on Optimism for any wallet-side gas costs
Buying an FID
Buy Now
- 1Open an active listing and choose Buy Now
- 2Connect the wallet that will be used for the purchase
- 3Enter the recovery address you want associated with the FID
- 4Sign the requested Farcaster transfer authorization
- 5Deposit the required payment into escrow
- 6Wait for payment confirmation and any required seller authorization
- 7Track the order while settlement completes
- 8Verify the FID has moved to your wallet after settlement
Before You Pay
- Confirm the FID number and listing details
- Confirm the wallet and recovery address you intend to use
- Review the total payment and any fees shown in checkout
- Make sure your wallet is on Optimism when requested
Selling an FID
Listing an FID
- 1Connect the wallet that controls the FID
- 2Open the sell flow and choose the FID to list
- 3Set your price and review the listing details
- 4Complete any requested authorization step
- 5Publish the listing
When a Buyer Pays
A paid order may require a fresh seller authorization before the FID can be transferred. Open the order using the seller wallet and follow the action shown on the order page.
Do not manually transfer the FID outside the order flow while a paid order is in progress. Doing so can prevent normal settlement.
Funded WETH Offers
Funded offers let a buyer make an offer backed by WETH on Optimism. The offer is funded before the seller accepts it, so the seller can see that funds have been secured for that offer.
Offer Flow
- 1Buyer enters the offer amount and recovery address
- 2Buyer signs the requested transfer authorization
- 3Buyer approves and funds the WETH offer
- 4The offer becomes available for the seller to review
- 5Seller accepts or rejects the offer
- 6An accepted funded offer becomes an order
- 7The normal settlement process completes the FID transfer and payment release
Offer States
Orders
Your order page is the main place to track a purchase or sale. It shows the current payment and settlement progress and any action required from your wallet.
Typical Progress
Use the Same Wallet
Buyer actions must be completed with the wallet used as the buyer on the order, and seller actions must be completed with the seller wallet. If you connect a different wallet, the required action may not appear.
Settlement
Settlement is the final stage of a transaction. FidMarket checks that the required payment and authorizations are ready, submits the FID transfer, verifies the result, and then completes the corresponding payment release.
What Can Delay Settlement
- A buyer or seller authorization has expired
- A required signature is still missing
- The seller no longer controls the expected FID
- The receiving wallet is not eligible for the transfer
- Payment or escrow confirmation is still pending
- An on-chain transaction needs additional review
Needs Review
If an order enters a needs-review state, the automated flow is paused so the transaction can be checked before any further action is taken. This is a safety state, not automatically a failed or lost transaction.
Account Management
Self-Service FID Transfer
Where available, account tools let an owner prepare and complete an FID transfer outside of a marketplace sale. The wallet must control the FID and any required recipient authorization must be completed.
Marketplace Restrictions
Some account actions may be temporarily unavailable while an FID has an active listing, paid order, accepted offer, or settlement in progress. This helps prevent conflicts between account changes and a marketplace transaction.
Username / Fname Management
An FID and its visible Farcaster username are related but are not the same thing. FID ownership is settled on-chain, while username updates may depend on additional Farcaster services and client propagation.
- An FID transfer may complete before a client shows every profile change
- Username changes may take time to propagate across Farcaster clients
- Some username actions may be blocked while a marketplace transaction is active
Notifications
FidMarket can surface transaction updates in the web app and, where enabled, through Telegram.
- Order and payment updates
- Buyer or seller action reminders
- Offer updates
- Settlement updates
- Review or failure notifications
Notifications are convenience alerts. For important transactions, always verify the current order page and relevant on-chain state.
Fees & Refunds
Fees
Any marketplace fees that apply to a transaction are shown as part of the checkout or transaction flow before the relevant payment is submitted.
Refund Destination
For escrowed Buy Now payments, a refund is returned according to the escrow terms for that order. In the current escrow flow, the refund destination is the original buyer wallet recorded when the payment was deposited.
A refund cannot be redirected to a different wallet after the deposit has already been made. If the original wallet is compromised or inaccessible, contact support before attempting a refund.
Do Not Pay Twice
If an existing paid order only asks you to refresh an authorization, do not create a second checkout or send another payment. Refreshing a signature is separate from payment.
Safety
Protect Your Wallet
- Never share your seed phrase or private key
- Check the connected wallet before signing
- Review the network and transaction details in your wallet
- Use a secure recovery address you control
Protect Your Trade
- Complete buyer and seller actions from the order page
- Do not manually transfer a listed FID during an active paid order
- Do not send extra payment because an authorization expired
- Pause and contact support if a wallet involved in an order is compromised
Troubleshooting
I am connected, but the expected button is missing
- Confirm you are on the normal order page rather than an unrelated page
- Confirm the connected wallet matches the buyer or seller on the order
- Refresh the page after reconnecting the wallet
- Make sure your wallet is on the requested network
My authorization expired
If the order page offers a refresh action, use it and sign the new authorization. You will not be charged again for refreshing an authorization.
My order says Needs Review
Do not create another order or send another payment. Keep the existing order ID and contact support so the current transaction can be reviewed safely.
My Farcaster client has not updated yet
On-chain FID ownership and what a Farcaster client displays can update at different times. Confirm the transaction status first, then allow time for client-side propagation where applicable.
Need more help?
Keep your order ID or listing ID available when requesting support. Never send anyone your wallet seed phrase or private key.