⚡ TPING English Auction

HTTP 402 Payment Required - TON Blockchain Implementation

▶ Current Status

Raised / Target
-- / --
Progress
--%
Start Price
--
Current Price
--
Tokens/TON
--
Time Remaining
--
Status: ACTIVE | Auto-refresh: 10s

▶ Place Bid

💎 Connect TON Wallet
Connect your wallet to auto-fill address and send payment directly
Auto-filled when wallet connected

▶ Recent Bids

BIDDER MAX PRICE AMOUNT BID TIME
Loading bids...

▶ API Endpoints

GET /api/auction/info
Get current auction status. Returns auction parameters, current price, total raised, and available supply.
curl https://x402.palette.finance/api/auction/info
GET /api/auction/bid?ton_amount=N&wallet=ADDR 402
Create a bid. Returns 402 Payment Required with payment instructions. One bid per wallet (1-100 TON).
curl "https://x402.palette.finance/api/auction/bid?ton_amount=5&wallet=UQBlen..."
Returns HTTP 402: Payment required. Send TON to address with bid_id as comment. Payment expires in 180 seconds. No refunds after payment.
GET /api/auction/my-bid?wallet=ADDR
Check your bid status. Returns bid details, payment status, and estimated token allocation.
curl "https://x402.palette.finance/api/auction/my-bid?wallet=UQBlen..."
GET /api/auction/bids?limit=20
Get recent bids list. Returns last N completed bids with bidder address, amount, price, and time.
curl "https://x402.palette.finance/api/auction/bids?limit=20"
Response Codes: 200 OK | 402 Payment Required | 409 Conflict (bid exists) | 410 Gone (auction closed) | 422 Invalid Amount

▶ Auction Mechanics

Parameter Value Description
Start Price -- Initial token price in TON
Ceiling Price -- Maximum token price
Min/Max Bid -- Bid limits per wallet
Supply -- Total TPING available
Rules: English Auction with rising price. One bid per wallet. Price increases as more TON is raised. Final allocation uses clearing price. Pro-rata distribution if oversubscribed.
📊 AUCTION SCENARIOS
[✓] SCENARIO 1: Target Reached (≥10,000 TON)
Success! All participants receive TPING tokens.

If demand ≤ supply:
• Everyone gets tokens at final price
• No refunds needed
• Example: 10K TON raised → 5M TPING distributed

If demand > supply (Oversubscribed):
• Pro-rata distribution applied
• You get: (your_bid / total_raised) × 5M TPING
• Excess TON refunded automatically
• Example: 15K TON raised, you bid 100 TON
  → You get: (100/15000) × 5M = 33,333 TPING
  → Cost: 33,333 × final_price = ~27 TON
  → Refund: 100 - 27 = 73 TON back
[✗] SCENARIO 2: Target NOT Reached (<10,000 TON)
Auction Failed. Full refund to all participants.

• NO tokens distributed (allocated_tping = 0)
• You receive back: your_bid - 0.01 TON (gas fee)
• Refunds processed automatically via distribute endpoint
• Example: You bid 50 TON → get back 49.99 TON