> ## Documentation Index > Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt > Use this file to discover all available pages before exploring further. # Token primary > Subscribe to primary pool updates for a token (based on liquidity) ## AsyncAPI ````yaml datastream/pool-token-updates.json tokenPrimary id: tokenPrimary title: Token primary description: Subscribe to primary pool updates for a token (based on liquidity) servers: - id: production protocol: wss host: datastream.solanatracker.io bindings: [] variables: - id: apiKey description: Your unique API key from Data API subscription allowedValues: [] examples: [] address: / parameters: [] bindings: [] operations: - &ref_3 id: subscribeToTokenPrimary title: Subscribe to token primary description: Subscribe to primary pool type: receive messages: - &ref_7 id: joinTokenPrimary payload: - name: joinTokenPrimary description: Subscribe to primary pool type: object properties: - name: type type: string description: join required: true - name: room type: string description: Token primary room required: true headers: [] jsonPayloadSchema: type: object required: - type - room properties: type: type: string const: join default: join x-parser-schema-id: room: type: string pattern: ^token:[A-Za-z0-9]{32,44}:primary$ description: Token primary room default: token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary x-parser-schema-id: examples: - type: join room: token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary x-parser-schema-id: title: Join token primary description: Subscribe to primary pool example: |- { "type": "join", "room": "token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary" } bindings: [] extensions: - id: x-parser-unique-object-id value: joinTokenPrimary - id: x-parser-message-name value: joinTokenPrimary bindings: [] extensions: &ref_0 - id: x-parser-unique-object-id value: tokenPrimary - &ref_5 id: receiveTokenPrimaryConfirmation title: Receive token primary confirmation description: Receive confirmation type: send messages: - &ref_9 id: tokenPrimaryJoined payload: - name: tokenPrimaryJoined description: Primary pool subscription confirmed type: object properties: - name: type type: string description: joined required: false - name: room type: string required: false headers: [] jsonPayloadSchema: type: object properties: type: type: string const: joined x-parser-schema-id: room: type: string x-parser-schema-id: examples: - type: joined room: token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary x-parser-schema-id: title: Token primary joined description: Primary pool subscription confirmed example: |- { "type": "joined", "room": "token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary" } bindings: [] extensions: - id: x-parser-unique-object-id value: tokenPrimaryJoined - id: x-parser-message-name value: tokenPrimaryJoined bindings: [] extensions: *ref_0 - &ref_6 id: receiveTokenPrimaryData title: Receive token primary data description: Receive primary updates type: send messages: - &ref_10 id: tokenPrimaryMessage payload: - name: tokenPrimaryMessage description: Primary pool update type: object properties: - name: type type: string description: message required: false - name: room type: string required: false - name: data type: object required: false properties: - name: poolId type: string required: false - name: liquidity type: object required: false properties: - name: quote type: number required: false - name: usd type: number required: false - name: price type: object required: false properties: - name: quote type: number required: false - name: usd type: number required: false - name: tokenSupply type: integer required: false - name: lpBurn type: number required: false - name: tokenAddress type: string required: false - name: marketCap type: object required: false properties: - name: quote type: number required: false - name: usd type: number required: false - name: decimals type: integer required: false - name: security type: object required: false properties: - name: freezeAuthority type: &ref_1 - string - 'null' required: false - name: mintAuthority type: &ref_2 - string - 'null' required: false - name: quoteToken type: string required: false - name: market type: string required: false - name: deployer type: string required: false - name: lastUpdated type: integer required: false - name: createdAt type: integer required: false - name: curvePercentage type: number required: false - name: curve type: string required: false - name: txns type: object required: false properties: - name: buys type: integer required: false - name: sells type: integer required: false - name: total type: integer required: false - name: volume type: number required: false - name: volume24h type: number required: false - name: bundleId type: string required: false - name: launchpad type: object required: false properties: - name: name type: string required: false - name: url type: string required: false - name: logo type: string required: false - name: baseLiquidity type: object required: false properties: - name: amount type: number required: false - name: usd type: number required: false - name: quoteLiquidity type: object required: false properties: - name: amount type: number required: false - name: usd type: number required: false - name: meteoraCurve type: object required: false properties: - name: baseLiquidity type: object required: false properties: - name: base type: number required: false - name: usd type: number required: false - name: quoteLiquidity type: object required: false properties: - name: quote type: number required: false - name: usd type: number required: false - name: fee type: number required: false - name: raydium type: object required: false properties: - name: baseLiquidity type: number required: false - name: quoteLiquidity type: number required: false - name: heaven type: object required: false properties: - name: baseLiquidity type: number required: false - name: quoteLiquidity type: number required: false - name: is_migrated type: boolean required: false - name: migrationTime type: integer required: false headers: [] jsonPayloadSchema: type: object properties: type: type: string const: message x-parser-schema-id: room: type: string x-parser-schema-id: data: type: object properties: poolId: type: string x-parser-schema-id: liquidity: type: object properties: quote: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: price: type: object properties: quote: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: tokenSupply: type: integer x-parser-schema-id: lpBurn: type: number x-parser-schema-id: tokenAddress: type: string x-parser-schema-id: marketCap: type: object properties: quote: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: decimals: type: integer x-parser-schema-id: security: type: object properties: freezeAuthority: type: *ref_1 x-parser-schema-id: mintAuthority: type: *ref_2 x-parser-schema-id: x-parser-schema-id: quoteToken: type: string x-parser-schema-id: market: type: string x-parser-schema-id: deployer: type: string x-parser-schema-id: lastUpdated: type: integer x-parser-schema-id: createdAt: type: integer x-parser-schema-id: curvePercentage: type: number x-parser-schema-id: curve: type: string x-parser-schema-id: txns: type: object properties: buys: type: integer x-parser-schema-id: sells: type: integer x-parser-schema-id: total: type: integer x-parser-schema-id: volume: type: number x-parser-schema-id: volume24h: type: number x-parser-schema-id: x-parser-schema-id: bundleId: type: string x-parser-schema-id: launchpad: type: object properties: name: type: string x-parser-schema-id: url: type: string x-parser-schema-id: logo: type: string x-parser-schema-id: baseLiquidity: type: object properties: amount: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: quoteLiquidity: type: object properties: amount: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: meteoraCurve: type: object properties: baseLiquidity: type: object properties: base: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: quoteLiquidity: type: object properties: quote: type: number x-parser-schema-id: usd: type: number x-parser-schema-id: x-parser-schema-id: fee: type: number x-parser-schema-id: x-parser-schema-id: raydium: type: object properties: baseLiquidity: type: number x-parser-schema-id: quoteLiquidity: type: number x-parser-schema-id: x-parser-schema-id: heaven: type: object properties: baseLiquidity: type: number x-parser-schema-id: quoteLiquidity: type: number x-parser-schema-id: is_migrated: type: boolean x-parser-schema-id: migrationTime: type: integer x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: Pool examples: - type: message data: liquidity: quote: 163461198.01587 usd: 288706913.4961454 price: quote: 5.962798160702177 usd: 5.962798160702177 tokenSupply: 999999284.625165 lpBurn: 0 tokenAddress: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN marketCap: quote: 5962793895.066426 usd: 5962793895.066426 market: meteora-dlmm quoteToken: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v decimals: 6 security: freezeAuthority: null mintAuthority: null lastUpdated: 1760272463414 createdAt: 1737196771000 poolId: 9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2 room: token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary x-parser-schema-id: title: Token primary message description: Primary pool update example: |- { "type": "message", "data": { "liquidity": { "quote": 163461198.01587, "usd": 288706913.4961454 }, "price": { "quote": 5.962798160702177, "usd": 5.962798160702177 }, "tokenSupply": 999999284.625165, "lpBurn": 0, "tokenAddress": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN", "marketCap": { "quote": 5962793895.066426, "usd": 5962793895.066426 }, "market": "meteora-dlmm", "quoteToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "decimals": 6, "security": { "freezeAuthority": null, "mintAuthority": null }, "lastUpdated": 1760272463414, "createdAt": 1737196771000, "poolId": "9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2" }, "room": "token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary" } bindings: [] extensions: - id: x-parser-unique-object-id value: tokenPrimaryMessage - id: x-parser-message-name value: tokenPrimaryMessage bindings: [] extensions: *ref_0 - &ref_4 id: unsubscribeFromTokenPrimary title: Unsubscribe from token primary description: Unsubscribe type: receive messages: - &ref_8 id: leaveTokenPrimary payload: - name: leaveTokenPrimary description: Unsubscribe from primary pool type: object properties: - name: type type: string description: leave required: true - name: room type: string required: true headers: [] jsonPayloadSchema: type: object required: - type - room properties: type: type: string const: leave default: leave x-parser-schema-id: room: type: string default: token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary x-parser-schema-id: examples: - type: leave room: token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary x-parser-schema-id: title: Leave token primary description: Unsubscribe from primary pool example: |- { "type": "leave", "room": "token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN:primary" } bindings: [] extensions: - id: x-parser-unique-object-id value: leaveTokenPrimary - id: x-parser-message-name value: leaveTokenPrimary bindings: [] extensions: *ref_0 sendOperations: - *ref_3 - *ref_4 receiveOperations: - *ref_5 - *ref_6 sendMessages: - *ref_7 - *ref_8 receiveMessages: - *ref_9 - *ref_10 extensions: - id: x-parser-unique-object-id value: tokenPrimary securitySchemes: - id: apiKeyAuth name: apiKey type: httpApiKey description: >- API key for authentication. Include your Datastream key in the connection URL: wss://datastream.solanatracker.io/{DATASTREAM_KEY} in: header extensions: [] ````