> ## Documentation Index > Fetch the complete documentation index at: https://tokenlayer-2a53bba4.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Trade tokens (buy or sell) > Prepares a transaction to buy or sell tokens. Supports multiple trade types: - **Buy exact input**: Spend specific USD amount - **Buy exact output**: Receive specific token amount - **Sell exact input**: Sell specific token amount - **Sell exact output**: Receive specific USD amount Automatically uses RobinSwap or UniswapV3 based on token graduation status. **USD Rewards Attribution:** - **Builder attribution**: Set custom builder fees (in basis points) to earn USD rewards on transactions - **Token referral**: Enable affiliate programs by specifying referral addresses for token trades - USD rewards are processed in real-time on-chain with no third parties involved - Token referrals have no additional cost to users - enabling affiliate programs onchain ## OpenAPI ````yaml post /trade-token openapi: 3.0.3 info: title: Thrust API version: 1.0.0 description: |2- Thrust is a social trading platform where users can create, trade, and engage with tokens. This API provides comprehensive access to token operations, social features (posts, voting, clubs), blockchain transactions, and real-time interactions. ## Base URL All endpoints are accessed via: `${SUPABASE_URL}/functions/v1/{endpoint}` ## Authentication Most endpoints require authentication using an JWT token or API key passed as a Bearer token in the Authorization header. ## Rate Limiting API calls are rate limited per user. Please implement appropriate backoff strategies. contact: name: Thrust API Support url: https://onthrust.com servers: - url: https://yppncslmsswqydhhgygz.supabase.co/functions/v1 description: Production server - url: https://yppncslmsswqydhhgygz.supabase.co/functions/v1 description: Staging server security: [] tags: - name: Tokens description: Token creation, browsing, search, trading, and price operations - name: Posts description: Creating and retrieving posts and topics - name: Voting description: Voting on posts, polls, tokens, and livestreams - name: Notifications description: User notifications management - name: Clubs description: Club and group management - name: Feed description: Timeline and feed operations - name: Transactions description: Blockchain transactions (send, tip, ownership checks) paths: /trade-token: post: tags: - Transactions - Tokens summary: Trade tokens (buy or sell) description: |2- Prepares a transaction to buy or sell tokens. Supports multiple trade types: - **Buy exact input**: Spend specific USD amount - **Buy exact output**: Receive specific token amount - **Sell exact input**: Sell specific token amount - **Sell exact output**: Receive specific USD amount Automatically uses RobinSwap or UniswapV3 based on token graduation status. **USD Rewards Attribution:** - **Builder attribution**: Set custom builder fees (in basis points) to earn USD rewards on transactions - **Token referral**: Enable affiliate programs by specifying referral addresses for token trades - USD rewards are processed in real-time on-chain with no third parties involved - Token referrals have no additional cost to users - enabling affiliate programs onchain operationId: tradeToken requestBody: content: application/json: schema: $ref: '#/components/schemas/TradeTokenRequest' responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/TradeTokenResponse' '400': description: Bad request - Invalid parameters content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized - Invalid or missing authentication content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' security: - BearerAuth: [] components: schemas: TradeTokenRequest: type: object properties: tokenId: type: string format: uuid userAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: >- User wallet address (optional - if not provided, will use user's Privy wallet from user_wallets table) example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' builder: $ref: '#/components/schemas/Builder' token_referral: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: >- Token referral address for attribution (optional - defaults to zero address). Used to attribute referral fees to a specific address. example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' chainSlug: $ref: '#/components/schemas/ChainSlug' direction: type: string enum: - buy - sell buyAmountUSD: type: number minimum: 0 exclusiveMinimum: true buyAmountToken: type: number minimum: 0 exclusiveMinimum: true sellAmountToken: type: number minimum: 0 exclusiveMinimum: true sellAmountUSD: type: number minimum: 0 exclusiveMinimum: true required: - tokenId - chainSlug - direction TradeTokenResponse: type: object properties: success: type: boolean enum: - true transaction: type: object properties: to: type: string data: type: string value: type: string gasLimit: type: string chain: $ref: '#/components/schemas/ChainSlug' required: - to - data - value - gasLimit - chain required: - success - transaction Error: type: object properties: success: type: boolean enum: - false error: type: string required: - success - error description: Error response Builder: type: object properties: code: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: Builder address for attribution example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' fee: type: integer minimum: 0 maximum: 10000 description: Builder fee in basis points (bps). 1 bps = 0.01%. Max 10000 (100%). example: 50 required: - code - fee description: >- Builder attribution information (optional). Includes address and fee in bps. ChainSlug: type: string enum: - solana-devnet - base - base-sepolia - avalanche - bnb - bnb-testnet - unichain - unichain-testnet - abstract - polygon - zkSync - zkSync-testnet description: >- Blockchain identifier. Supported chains: solana-devnet, base, base-sepolia, avalanche, bnb, bnb-testnet, unichain, unichain-testnet, abstract, polygon, zkSync, zkSync-testnet example: base-sepolia securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT token or API key ````