API Reference

Base URL

https://ultradex.finance/api

Endpoints

1. Create User

POST /api/campaign

Request: { "address": "0x742d...bEb", "referralCode": "ABC123" }

Response: { "user": { "address": "0x742d35...", "points": 1, "referral_code": "742D35" } }

2. Get User Data

GET /api/campaign?address=0x...

Response: { "user": { ... }, "quests": [ ... ], "referrals": [ ... ] }

3. Claim Swap

POST /api/claim-swap

Request: { "address": "0x742d35...", "txHash": "0xabc123...", "volume": 100.50 }

Response: { "success": true, "swaps": 1 }

4. Claim Stake

POST /api/claim-stake

Request: { "address": "0x742d35...", "txHash": "0xabc123...", "amount": "1.5", "type": "stake" }

Response: { "success": true }

5. Claim Quest

POST /api/claim-quest

Request: { "address": "0x742d35...", "questType": "firstSwap" }

Response: { "success": true, "points": 1 }

6. Verify Twitter

POST /api/verify-twitter

Request: { "address": "0x742d35...", "twitterUsername": "username" }

Response: { "success": true }

7. Verify Telegram

POST /api/verify-telegram

Request: { "address": "0x742d35...", "telegramUsername": "username" }

Response: { "success": true }

8. Claim Donation

POST /api/claim-donation

Request: { "address": "0x742d35...", "txHash": "0xabc123..." }

Response: { "success": true, "points": 5, "amount": 5.0 }

9. Leaderboard

GET /api/leaderboard?limit=50

Response: { "leaderboard": [ { "rank": 1, "address": "0x742d...bEb", "points": 150, "swaps": 25, "volume": "5000.00" } ] }