Farcaster FID marketplace

FidMarket Documentation

A practical guide for buying, selling, making offers, managing authorizations, and completing Farcaster FID transactions on FidMarket.

Introduction

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

FidMarket transactions and Farcaster FID settlement use Optimism. Your wallet may need to be switched to Optimism for payment or signing steps.

Wallet-first

Your connected wallet is used to authenticate and authorize marketplace actions. FidMarket will never ask for your seed phrase or private key.

Escrow-backed

Supported purchase and offer flows use escrow so payment is not released until the transaction reaches the appropriate settlement stage.

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

  1. 1Open an active listing and choose Buy Now
  2. 2Connect the wallet that will be used for the purchase
  3. 3Enter the recovery address you want associated with the FID
  4. 4Sign the requested Farcaster transfer authorization
  5. 5Deposit the required payment into escrow
  6. 6Wait for payment confirmation and any required seller authorization
  7. 7Track the order while settlement completes
  8. 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

  1. 1Connect the wallet that controls the FID
  2. 2Open the sell flow and choose the FID to list
  3. 3Set your price and review the listing details
  4. 4Complete any requested authorization step
  5. 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

  1. 1Buyer enters the offer amount and recovery address
  2. 2Buyer signs the requested transfer authorization
  3. 3Buyer approves and funds the WETH offer
  4. 4The offer becomes available for the seller to review
  5. 5Seller accepts or rejects the offer
  6. 6An accepted funded offer becomes an order
  7. 7The normal settlement process completes the FID transfer and payment release

Offer States

Open
The offer is active and awaiting seller action.
Accepted
The seller accepted the offer and an order is being processed.
Rejected
The seller declined the offer.
Cancelled
The offer was cancelled under the available cancellation rules.
Expired
The offer deadline passed before completion.

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

Payment pending
The order is waiting for the required payment or payment confirmation.
Action required
The buyer or seller needs to sign or refresh an authorization.
Settling
The FID transfer and payment release are being processed.
Completed
Settlement completed successfully.
Needs review
The order has been paused for manual review instead of continuing automatically.

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.

Authorizations

Farcaster FID transfers require signed authorizations. These signatures are transaction permissions; they do not reveal your private key and they do not give FidMarket access to your wallet.

Authorization Expiry

Authorizations have deadlines. If an order takes longer than the authorization window, you may be asked to refresh and sign a new authorization before settlement can continue.

Refreshing an authorization does not charge the buyer again. It only replaces an expired transaction permission with a fresh one.

If You See “Refresh buyer authorization”

  1. 1Make sure you are connected with the original buyer wallet
  2. 2Click Refresh buyer authorization
  3. 3Review the refreshed transfer details
  4. 4Sign the new authorization in your wallet
  5. 5Return to the order page and wait for the seller or settlement step

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.