Filling Orders
Ready to buy some tokens? This guide shows you how to fill existing orders on Brtr.
Finding Orders
Browse the Discover Page
Head to the Discover (opens in a new tab) page to see all available orders:
Use the filters to find what you want:
- Chain — Show only orders from specific blockchains
- Search — Look for specific tokens or sellers
- Sort — Newest, oldest, or most popular first
What Each Order Card Shows
Each order card displays:
- "You Get" — The token being offered and amount
- "Pay With" — Payment options the seller accepts
- Seller address — Who created the order
- Status — Active, Processing, Completed, etc.
How to Fill an Order
Step 1: Pick an Order
Click on any order card to see full details, or hit "Buy Now" to fill immediately.
Step 2: Choose Your Payment Option
If the seller accepts multiple payment options, pick the one that works best for you:
Think about:
- Do you have enough? — Check your wallet balance
- Same chain or cross-chain? — Same chain is faster and cheaper
- Gas costs — Cross-chain needs more ETH for LayerZero fees
Step 3: Review the Details
Before you fill, you'll see:
- What you're paying (your tokens)
- What you'll receive (seller's tokens minus 0.5% fee)
- Your fee (0.3% on your payment)
- Estimated gas cost
Cross-chain fills need extra ETH for gas on both blockchains. The app calculates this automatically and shows you the total.
Step 4: Complete the Fill
Filling on the Same Blockchain
- Approve your tokens (first time only)
- Click "Buy Now"
- Sign the transaction in your wallet
- Wait a few seconds
- Done! Tokens arrive instantly
Same-chain fills complete atomically in one transaction.
After You Fill
Same-Chain Fills
Tokens arrive instantly in your wallet. Check your wallet balance or view the transaction in your blockchain explorer.
Cross-Chain Fills
Track progress in the app — you'll see states like:
| State | What's Happening |
|---|---|
| Processing | Your payment is escrowed |
| AwaitingConfirmation | Seller's chain is locking tokens |
| AwaitingFinalization | Almost done |
| Completed | Tokens in your wallet |
Cross-chain fills typically take 2-5 minutes. Track message status on LayerZero Scan (opens in a new tab).
Tips for Buyers
Compare Prices
- Check multiple orders for the same token
- Consider the total cost (price + fees + gas)
- Same-chain fills are cheaper than cross-chain
Understand the Fees
- Seller pays: 0.5% on their tokens (you receive slightly less)
- You pay: 0.3% on your payment
- Gas: Variable based on chain and cross-chain messaging
Stay Safe
- Verify you're filling for the right token
- Check the seller's trading history on their Stall
- Start with smaller amounts if unsure
Common Questions
Q: What if the fill fails? A: Your tokens are returned automatically. No fees charged on failed transactions.
Q: How do I know the fill completed? A: You'll see a success message, and tokens appear in your wallet.
Q: Can I cancel after clicking Buy Now? A: No, once you sign the transaction, the fill proceeds. Review carefully before confirming.
Q: Why is my cross-chain fill taking so long? A: Cross-chain fills involve 3 messages via LayerZero. Wait 5-10 minutes. Check LayerZero Scan (opens in a new tab) for status.
Q: What if a cross-chain fill gets stuck? A: After 30 minutes, recovery functions become available. You can refund your escrowed tokens if the confirmation never arrived. Contact support if needed.
Q: I filled an order but don't see the tokens. A: Make sure you're on the correct chain. You may need to add the token to your wallet using its contract address.