> ## 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. # Top10 holders > Subscribe to top 10 holders percentage changes for a token ## AsyncAPI ````yaml datastream/asyncapi.json top10Holders id: top10Holders title: Top10 holders description: Subscribe to top 10 holders percentage changes for a token 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_1 id: subscribeToTop10 title: Subscribe to top10 description: Subscribe to top 10 holders type: receive messages: - &ref_5 id: joinTop10 payload: - name: joinTop10 description: Subscribe to top 10 holders type: object properties: - name: type type: string description: join required: true - name: room type: string description: Top 10 room (top10:{tokenAddress}) 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: ^top10:[A-Za-z0-9]{32,44}$ description: Top 10 room (top10:{tokenAddress}) default: top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN x-parser-schema-id: examples: - type: join room: top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN x-parser-schema-id: title: Join top10 description: Subscribe to top 10 holders example: |- { "type": "join", "room": "top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN" } bindings: [] extensions: - id: x-parser-unique-object-id value: joinTop10 - id: x-parser-message-name value: joinTop10 bindings: [] extensions: &ref_0 - id: x-parser-unique-object-id value: top10Holders - &ref_3 id: receiveTop10Confirmation title: Receive top10 confirmation description: Receive top 10 confirmation type: send messages: - &ref_7 id: top10Joined payload: - name: top10Joined description: Top 10 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: top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN x-parser-schema-id: title: Top10 joined description: Top 10 subscription confirmed example: |- { "type": "joined", "room": "top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN" } bindings: [] extensions: - id: x-parser-unique-object-id value: top10Joined - id: x-parser-message-name value: top10Joined bindings: [] extensions: *ref_0 - &ref_4 id: receiveTop10Data title: Receive top10 data description: Receive top 10 updates type: send messages: - &ref_8 id: top10Message payload: - name: top10Message description: Top 10 holders update notification 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: token type: string required: false - name: holders type: array required: false - name: totalPercentage type: number required: false - name: previousPercentage type: number required: false - name: timestamp 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: token: type: string x-parser-schema-id: holders: type: array items: type: object properties: address: type: string x-parser-schema-id: amount: type: string x-parser-schema-id: percentage: type: number x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: totalPercentage: type: number x-parser-schema-id: previousPercentage: type: number x-parser-schema-id: timestamp: type: integer x-parser-schema-id: x-parser-schema-id: Top10Holders examples: - type: message room: top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN data: token: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN holders: - address: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM amount: '50000' percentage: 5 - address: 8qJSyQprMC57TWKaYEmetUR3UUiTP2M3hXdcvFhkZdmv amount: '45000' percentage: 4.5 - address: GUfCR9mK6azb9vcpsxgXyj7XRPAKJd4KMHTTVvtncGgp amount: '40000' percentage: 4 - address: FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T amount: '35000' percentage: 3.5 - address: 6WecYymEARvjG5ZyqkrVQ6YkhPfujNzWpSPwNKXHCbV2 amount: '30000' percentage: 3 - address: DjVE6JNiYqPL2QXyCUUh8rNjHrbz9hXHNYt99MQ59qw1 amount: '28000' percentage: 2.8 - address: 7Vbq5xhH4WvqCwsQTZzaYGKg7QzLNnYANbDmaFhEZ9JK amount: '25000' percentage: 2.5 - address: 3ZpKrAcBGxvAkhfJdPBCwGcCCGwEWjNkGLfMkWgGjXfR amount: '23000' percentage: 2.3 - address: Ez2zVjw85tZan1ycnJ5PywNNxR7jEFJDVRKuPuUTEPHC amount: '20000' percentage: 2 - address: 9nEqaUcb16sQ3Tn1psbkWqyhPdLmfHWjKGymREjZgyQT amount: '18000' percentage: 1.8 totalPercentage: 31.4 previousPercentage: 28.7 timestamp: 1739318753652 x-parser-schema-id: title: Top10 message description: Top 10 holders update notification example: |- { "type": "message", "room": "top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN", "data": { "token": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN", "holders": [ { "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", "amount": "50000", "percentage": 5 }, { "address": "8qJSyQprMC57TWKaYEmetUR3UUiTP2M3hXdcvFhkZdmv", "amount": "45000", "percentage": 4.5 }, { "address": "GUfCR9mK6azb9vcpsxgXyj7XRPAKJd4KMHTTVvtncGgp", "amount": "40000", "percentage": 4 }, { "address": "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T", "amount": "35000", "percentage": 3.5 }, { "address": "6WecYymEARvjG5ZyqkrVQ6YkhPfujNzWpSPwNKXHCbV2", "amount": "30000", "percentage": 3 }, { "address": "DjVE6JNiYqPL2QXyCUUh8rNjHrbz9hXHNYt99MQ59qw1", "amount": "28000", "percentage": 2.8 }, { "address": "7Vbq5xhH4WvqCwsQTZzaYGKg7QzLNnYANbDmaFhEZ9JK", "amount": "25000", "percentage": 2.5 }, { "address": "3ZpKrAcBGxvAkhfJdPBCwGcCCGwEWjNkGLfMkWgGjXfR", "amount": "23000", "percentage": 2.3 }, { "address": "Ez2zVjw85tZan1ycnJ5PywNNxR7jEFJDVRKuPuUTEPHC", "amount": "20000", "percentage": 2 }, { "address": "9nEqaUcb16sQ3Tn1psbkWqyhPdLmfHWjKGymREjZgyQT", "amount": "18000", "percentage": 1.8 } ], "totalPercentage": 31.4, "previousPercentage": 28.7, "timestamp": 1739318753652 } } bindings: [] extensions: - id: x-parser-unique-object-id value: top10Message - id: x-parser-message-name value: top10Message bindings: [] extensions: *ref_0 - &ref_2 id: unsubscribeFromTop10 title: Unsubscribe from top10 description: Unsubscribe from top 10 type: receive messages: - &ref_6 id: leaveTop10 payload: - name: leaveTop10 description: Unsubscribe from top 10 holders 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: top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN x-parser-schema-id: examples: - type: leave room: top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN x-parser-schema-id: title: Leave top10 description: Unsubscribe from top 10 holders example: |- { "type": "leave", "room": "top10:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN" } bindings: [] extensions: - id: x-parser-unique-object-id value: leaveTop10 - id: x-parser-message-name value: leaveTop10 bindings: [] extensions: *ref_0 sendOperations: - *ref_1 - *ref_2 receiveOperations: - *ref_3 - *ref_4 sendMessages: - *ref_5 - *ref_6 receiveMessages: - *ref_7 - *ref_8 extensions: - id: x-parser-unique-object-id value: top10Holders 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: [] ````