tradeit.gg
← Back to Index

Architecture · ops.tradeit.gg

API Endpoints Mapping

Contents

Overview

This document provides a comprehensive list of all API endpoints in the Tradeit platform, grouped by functionality, along with the full application flow.

Base URL Structure

1. Authentication & User Management

Steam Authentication

Base: /api/v2/steam

MethodEndpointAuthDescription
GET/loginNoSteam OAuth login - redirects to Steam
POST/login-codeNoGenerate login code via trade URL
POST/attempt-login-codeNoAttempt login with code
GET/offer-idNoGet trade offer ID for login

User Management

Base: /api/v2/user

MethodEndpointAuthDescription
GET/dataYesGet user profile data
GET/transactionsYesGet user transaction history
PUT/trade-urlYesSet/update trade URL
PUT/emailYesSet/update user email
PUT/tradeUrlAndEmailYesSet both trade URL and email
PUT/verify-emailYesRequest email verification
PUT/confirm-emailNoConfirm email with token
POST/logoutYesLogout user
POST/check-steam-guardYesCheck Steam Guard status
POST/likeYesLike an item
PUT/likeYesUnlike an item
POST/set-analytics-attributesYesSave analytics attributes
GET/get-intercom-hashYesGet Intercom hash for user
POST/log-first-transactionYesLog first transaction event
GET/countriesYesGet list of countries

Affiliate System

Base: /api/v2/user

MethodEndpointAuthDescription
PUT/affiliate-codeYesSet affiliate code
POST/affiliateYesUpdate affiliate slug
POST/affiliate/claim-bonusYesClaim affiliate balance
GET/affiliate/statisticsYesGet affiliate statistics
GET/affiliate/historiesYesGet affiliate revenue history

First Trade Bonus

Base: /api/v2/user

MethodEndpointAuthDescription
POST/first-tradeYesInitialize first trade bonus
POST/first-trade-bonusYesClaim first trade bonus

Stripe Integration

Base: /api/v2/user

MethodEndpointAuthDescription
GET/stripeYesGet Stripe account info
POST/stripeYesCreate Stripe account
DELETE/stripeYesRemove Stripe account
GET/stripe-linkYesGet Stripe login link

2. Trading System

Trade Operations

Base: /api/v2/trade

MethodEndpointAuthDescription
POST/YesCreate a new trade
POST/reservedYesCreate trade with reserved items
POST/continue-resolvedYesContinue a resolved trade
POST/virtualYesAccept virtual trade
GET/lastTradesNoGet last completed trades
POST/checkBalanceYesCheck balance limit for trade
POST/checkTradeYesValidate trade before creation
POST/purchaseYesPurchase items from trade

Flow:

  1. User selects items from inventory
  2. System checks balance/limits (/checkBalance, /checkTrade)
  3. User creates trade (POST /)
  4. System processes trade with Steam bots
  5. Trade completion updates user balance

3. Inventory Management

Base: /api/v2/inventory

MethodEndpointAuthDescription
GET/dataNoGet public inventory data
GET/csgo-itemsNoGet CS:GO items data
GET/my/dataYesGet user's inventory
POST/check-availableYesCheck if assets are available
POST/search-tradeNoSearch items for trade
GET/my/reservedYesGet user's reserved items
GET/reserve-itemsNoGet available reserve items
GET/items-pricesNoGet prices for items
GET/searchNoSearch inventory for user
GET/stickersNoGet sticker data
GET/csgo-full-imgNoGet full CS:GO item image
GET/inventory-reserve-itemsYesGet inventory reserve items
GET/withdraw-reserve-itemsYesGet withdrawable reserve items
GET/has-lootbearYesCheck if user has Lootbear items

Flow:

  1. User connects Steam account
  2. System fetches inventory from Steam (/my/data)
  3. Items are cached and priced
  4. User can reserve items for trade
  5. Reserved items tracked separately

4. Selling System

Base: /api/v2/sell

MethodEndpointAuthDescription
POST/listingYesList item for sale
POST/withdrawYesWithdraw sale offer (crypto payout)
GET/offersYesGet user's sale offers
GET/statisticsYesGet selling statistics
GET/soldItemsYesGet sold items history
GET/payoutHistoriesYesGet payout history
GET/payoutStatisticYesGet payout statistics
POST/edit-sale-priceYesEdit sale item price
POST/delist-sale-itemYesRemove item from sale
POST/sell-reserved-itemsYesSell reserved items
POST/trade-reserved-itemsYesTrade reserved items

Flow:

  1. User lists item for sale (POST /listing)
  2. Item appears in marketplace
  3. Buyer purchases item
  4. Seller receives balance or requests payout
  5. Payout processed via crypto/Stripe (POST /withdraw)

5. Payment System

Payment Processing

Base: /api/v2/payment

MethodEndpointAuthDescription
POST/tokenNoGet payment token (PayPal)

Stripe Payments

Base: /api/v2/stripe

MethodEndpointAuthDescription
GET/topup-transaction/:orderIdYesGet topup transaction status
POST/create-sessionYesCreate Stripe checkout session
POST/payment-intentYesCreate payment intent
POST/payment-method-configsYesGet payment method configs

Crypto Payments (NowPayments)

Base: /api/v2/nowpayment

MethodEndpointAuthDescription
POST/payoutsNoIPN webhook for payouts
POST/paymentsNoIPN webhook for payments
POST/create-chargeYesCreate crypto payment charge

Monnect Payments

Base: /api/v2/monnect

MethodEndpointAuthDescription
POST/create-signatureYesCreate payment signature
POST/authorize-transactionNoAuthorize transaction
POST/whNoWebhook handler

Crypto Webhooks

Base: /api/v2/crypto

MethodEndpointAuthDescription
POST/cryptopaymentNoCrypto payment webhook
GET/cryptopaymentstatusNoCheck crypto payment status

Flow:

  1. User selects payment method (Stripe/Crypto/Monnect)
  2. Create payment session/intent
  3. Process payment via webhook
  4. Update user balance on success
  5. Transaction logged in balance_transactions

6. Store & Purchases

Base: /api/v2/store

MethodEndpointAuthDescription
POST/purchaseYesPurchase from store
POST/ordersYesGet Halo offer information
POST/stripe-webhookNoStripe webhook handler

Flow:

  1. User browses store items
  2. Add items to cart
  3. Purchase creates order
  4. Payment processed
  5. Items added to inventory

7. Investment System

Base: /api/v2/invest

MethodEndpointAuthDescription
POST/enterYesEnter investment (deposit)
POST/exitYesExit investment (withdraw)
GET/non-logged-inNoGet investment data (public)
GET/logged-inYesGet investment data (user)

Flow:

  1. User deposits balance into investment
  2. System tracks investment position
  3. Interest calculated daily (cron job)
  4. User can withdraw investment
  5. Returns calculated based on market performance

8. Giveaway System

Base: /api/v2/giveaway

MethodEndpointAuthDescription
GET/NoGet active giveaways
GET/winnersNoGet giveaway winners
GET/my/entriesYesGet user's giveaway entries
POST/joinYesJoin a giveaway
GET/cron/scheduleGiveawaysNoSchedule giveaways (cron)
POST/cron/chooseWinnersNoChoose winners (cron)

Flow:

  1. Admin creates giveaway
  2. Users join with tickets
  3. Cron job selects winners
  4. Winners receive items/balance

9. Guess Game

Base: /api/v2/guess-game

MethodEndpointAuthDescription
GET/:idNoGet game board
GET/:id/leaderboardNoGet leaderboard
POST/:id/start-gameYesStart a game
POST/:id/answerYesSubmit answer

Flow:

  1. User starts game
  2. System shows item image
  3. User guesses price
  4. Score calculated
  5. Leaderboard updated

10. Challenges

Base: /api/v2/challenges

MethodEndpointAuthDescription
GET/NoGet available challenges
POST/initYesInitialize challenge
POST/claimYesClaim challenge reward

Flow:

  1. User views challenges
  2. Completes challenge requirements
  3. Claims reward
  4. Balance/items added

11. Market Insights & Analytics

Base: /api/v2/insights

MethodEndpointAuthDescription
GET/chart/:gameId/containerNoGet container chart data
GET/chart/:gameId/container/:slugNoGet item in container chart
GET/chart/:gameId/collection/:slug?NoGet collection chart data
GET/chart/:gameId/item/:itemIdNoGet item chart data
GET/chart/:gameId/:slug?NoGet category chart data
GET/items/:gameId/containerNoGet container items
GET/items/:gameId/container/:slug?NoGet items in container
GET/items/:gameId/collection/:slug?NoGet items in collection
GET/items/:gameId/:slug?NoGet category items
GET/category/:gameId/:slug?NoGet category data
GET/stock-data/:gameId/:itemIdNoGet item stock data
GET/generate-contents/:gameIdNoGenerate market insight content
GET/graffiti-multi-skinsNoGet sealed graffiti multi skins map

12. Categories & Meta Data

Categories

Base: /api/v2/categories

MethodEndpointAuthDescription
GET/NoGet all categories
GET/skins-countNoGet skins count
GET/:gameIdNoGet categories by game ID
GET/by-parents/:parentIdsNoGet categories by parent IDs
GET/tree/:appIdNoGet categories tree
GET/slug/:slugNoGet category by slug

Meta Data

Base: /api/v2/meta

MethodEndpointAuthDescription
GET/itemNoGet item metadata
GET/typeNoGet type metadata
GET/parent-typeNoGet parent type metadata
GET/collectionNoGet collection metadata
GET/containerNoGet container metadata
GET/wiki/urlsNoGet wiki URLs
GET/top-itemsNoGet top items
GET/itemsNoGet meta items by app ID
GET/playerNoGet pro player data
GET/playersNoGet players by team
GET/seo-itemsNoGet meta items by slug (SEO)
GET/landing-page-itemsNoGet items for landing page
GET/item-searchNoSearch items
POST/track-item-searchNoTrack item search

13. Skin Collections

Base: /api/v2/skinCollections

MethodEndpointAuthDescription
POST/YesCreate skin collection
GET/NoGet all collections
GET/itemsYesGet collection items
GET/tagsNoGet collection tags
GET/metaNoGet collection metadata
GET/:idNoGet collection by ID
POST/:idYesUpdate collection
DELETE/:idYesDelete collection
POST/:id/voteYesUpvote collection
DELETE/:id/voteYesDownvote collection

14. Coupons & Discounts

Base: /api/v2/coupons

MethodEndpointAuthDescription
POST/NoApply coupon
DELETE/NoRemove coupon
GET/:id/checkNoCheck coupon validity
POST/validateYesValidate coupon (logged in)

15. Configuration & Settings

Configuration

Base: /api/v2/configurations

MethodEndpointAuthDescription
GET/NoGet site configuration
GET/statsNoGet site statistics
GET/csgo-collectionsNoGet CS:GO collections

User Settings

Base: /api/v2/settings

MethodEndpointAuthDescription
GET/YesGet user settings
POST/YesUpdate user settings

16. Deposit Details

Base: /api/v2/deposit-details

MethodEndpointAuthDescription
GET/YesGet deposit details
GET/convert-rateYesGet conversion rate

17. Exchange Rates

Base: /api/v2/exchange-rate

MethodEndpointAuthDescription
GET/NoGet exchange rates

18. Server Status

Base: /api/v2/server-status

MethodEndpointAuthDescription
GET/steam-poweredNoCheck Steam Powered status
GET/statsNoGet server statistics
POST/report-issueNoReport server issue

19. SEO & Content

Base: /api/v2/seo

MethodEndpointAuthDescription
GET/page-contentsNoGet SEO page content

20. Blogs

Base: /api/v2/blogs

MethodEndpointAuthDescription
GET/NoGet latest blogs

21. Contact Us

Base: /api/v2/contact-us

MethodEndpointAuthDescription
POST/NoSubmit contact form

22. Card Verification (Stripe)

Base: /api/v2/card

MethodEndpointAuthDescription
POST/verifyYesVerify card
GET/card-verificationsYesGet card verification data
POST/card-verifications/removeYesRemove card verification

23. OAuth2 Integration

Base: /api/v2/oauth2

MethodEndpointAuthDescription
POST/request-codeYesRequest OAuth2 code
POST/notification-rewardYesClaim notification reward

24. Lootbear Integration

Base: /api/v2/lootbear

MethodEndpointAuthDescription
GET/items/stocksNoGet items stock details
GET/invest/:steamIdNoGet Lootbear investment
POST/investNoProcess Lootbear investment

25. NFT (Placeholder)

Base: /api/v2/nft

MethodEndpointAuthDescription
POST/NoNFT placeholder endpoint

Base: /api/v2/termly

MethodEndpointAuthDescription
POST/NoSave cookie consent

27. Admin & Internal Commands

Base: /api/v2/commands

MethodEndpointAuthDescription
POST/verify-cardNoVerify card (admin)
POST/change-limitNoChange user limit
POST/ban-userNoBan user
POST/unban-userNoUnban user
POST/add-balanceNoAdd balance to user
POST/add-store-balanceNoAdd store balance
POST/delete-reserved-itemNoDelete reserved item
POST/create-reserved-itemNoCreate reserved item
POST/clear-reserved-itemsNoClear reserved items
POST/add-ticketNoAdd giveaway ticket
POST/set-site-disableNoSet site disable flag
POST/restart-pm2NoRestart PM2
POST/force-unstore-from-botNoForce unstore from bot
POST/disable-userNoDisable user
POST/restart-serversNoRestart servers
GET/restart-servers-statusNoGet restart status
POST/update-deposit-item-statusNoUpdate deposit item status
GET/update-guess-game-score/:idNoUpdate guess game score
POST/ban-guess-game-user/:idNoBan guess game user
POST/verify-payment-id-verificationNoVerify payment ID

28. Cron Jobs

Base: /api/v2/cron

MethodEndpointAuthDescription
POST/cleanBadPurchaseNoClean bad purchases
POST/refundBlockIdsNoRefund blocked IDs
POST/cleanReservedItemsNoClean reserved items
GET/rollback3DayFailedPurchasesNoRollback failed purchases
GET/migrateMailchimp/:start/:end/:batchNoMigrate Mailchimp
GET/inventoryDailyTrackingNoDaily inventory tracking
GET/checkInventoryValueNoCheck inventory value
GET/checkLastFinishedTradeNoCheck last finished trade
GET/clearBadSalesNoClear bad sales
GET/checkBotValueNoCheck bot value
POST/updateProPlayersItemsNoUpdate pro players items
POST/fixStuckDopplerPricesNoFix stuck Doppler prices
GET/generateTrendingTagsNoGenerate trending tags
GET/generateListingHackNoGenerate listing hack
GET/addInvestInterestNoAdd investment interest
GET/checkMaxPrepareStatementNoCheck max prepare statement
GET/updateTradeLockCountNoUpdate trade lock count
GET/updateReserveAndSaleCountNoUpdate reserve and sale count
GET/syncItemPricesNoSync item prices
GET/syncNewPriceItemFromPricingDbNoSync new prices from pricing DB
GET/getSeoPageContentURIsNoGet SEO page content URIs
GET/cleanBadNowpaymentPaymentNoClean bad NowPayments
GET/updateHaloOrderNoUpdate Halo order
POST/:gameId/marketNoUpdate market index
GET/trimOutValueInHourRedisKeyNoTrim Redis keys
GET/tradeSurgeNoTrade surge check
GET/checkRevertIssueNoCheck revert issue
GET/update-bots-levelsNoUpdate bots levels
GET/checkRevertTradeNoCheck revert trade
GET/sendBotCheckRevertTradeNoSend bot check revert trade
GET/instantSellCheckNoInstant sell check
GET/:gameId/market-trendsNoTrigger CS2 market trends
GET/handleReservedItemsRefundNoHandle reserved items refund
GET/cleanupContainerNoCleanup container

29. Internal Operations

Base: /api/v2/internal

MethodEndpointAuthDescription
POST/checkTradeLimitNoCheck trade limit
POST/check-block-tradeNoCheck blocked trade
POST/checkSendTradeLimitNoCheck send trade limit
POST/sendNewsletterNoSend newsletter
GET/sendSteamDownMessageNoSend Steam down message
POST/loadImageNoLoad image
POST/validate-csgo-itemsNoValidate CS:GO items
GET/queueInfoNoGet queue info
POST/processWithdrawSellNoProcess withdraw sell
POST/nowpayment2faCodeNoNowPayments 2FA code
POST/declineWithdrawSell/:idNoDecline withdraw sell
POST/faceit/eventNoSend Faceit event
POST/faceit/code-applyNoRedeem Faceit challenge
POST/oauth2-consume-balanceNoOAuth2 consume balance
GET/cleanup-orphaned-container-itemsNoCleanup orphaned items
GET/:gameId/deleteInsightKeysNoDelete insight keys
GET/clearReservedTablesNoClear reserved tables
GET/checkLostLootbearItemNoCheck lost Lootbear item
GET/checkMissingPaymentOnStoreNoCheck missing payment

Full Application Flow

1. User Registration & Authentication Flow

1. User visits site
2. Clicks "Login with Steam"
3. Redirected to Steam OAuth
4. Steam redirects back with auth token
5. Backend validates token
6. Creates/updates user in database
7. Sets session cookie
8. User logged in

2. Trading Flow

1. User logs in
2. Connects Steam inventory (fetches via Steam API)
3. Inventory cached in Redis
4. User selects items to trade
5. System checks:
   - Item availability
   - User balance limits
   - Trade restrictions
6. User creates trade offer
7. System:
   - Reserves items
   - Calculates prices
   - Selects bot
   - Creates Steam trade offer
8. User accepts trade on Steam
9. Bot accepts trade
10. Trade completed:
    - Items transferred
    - Balance updated
    - Transaction logged

3. Selling Flow

1. User selects item from inventory
2. Sets sale price
3. Item listed in marketplace
4. Buyer purchases item
5. System:
   - Removes item from sale
   - Adds balance to seller
   - Logs transaction
6. Seller can:
   - Keep balance
   - Request payout (crypto/Stripe)

4. Payment Flow

1. User adds items to cart
2. Proceeds to checkout
3. Selects payment method:
   - Stripe (card)
   - Crypto (NowPayments)
   - Monnect
4. Payment processed:
   - Stripe: Create session → Webhook → Update balance
   - Crypto: Create charge → IPN webhook → Update balance
5. Balance added to user account
6. Transaction logged

5. Investment Flow

1. User deposits balance into investment
2. System tracks position
3. Daily cron job:
   - Calculates interest
   - Updates investment value
4. User can withdraw:
   - Calculates returns
   - Updates balance
   - Closes position

6. Database Schema Overview

Core User Tables:

Trading Tables:

Selling Tables:

Inventory & Items:

Payment Tables:

Affiliate System:

Investment System:

Giveaway System:

Challenges:

Categories & Meta:

Store & Purchases:

Coupons:

Configuration:

Other Tables:

7. Technology Stack

Backend:

Frontend:

Services:

Authentication Middleware

Most endpoints use [loggedIn] middleware which:

  1. Checks session for Steam ID
  2. Validates user exists
  3. Attaches user object to request
  4. Returns 401 if not authenticated

Error Handling

All endpoints return:

{
  "success": true/false,
  "data": {...} or "message": "..."
}

Status codes:

Rate Limiting & Security

Notes

ops.tradeit.gg — Internal Engineering Docs