> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shuriken.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Alpha Call Context for a Token



## OpenAPI

````yaml GET /api/v2/alpha/tokens/{tokenAddress}/call-context
openapi: 3.0.3
info:
  description: Multi-chain DEX trading API for developers
  license:
    name: ''
  title: Shuriken API v2
  version: 2.0.0
servers:
  - url: https://api.shuriken.trade
security: []
tags:
  - description: SplitNOW cross-chain split plan + execute
    name: V2 Splits
  - description: Wallet archive lifecycle (archive / unarchive / bulk-archive)
    name: Wallets
  - description: Token discovery, metadata, and pricing
    name: V2 Tokens
  - description: Quote and execute swaps
    name: V2 Swap
  - description: Limit orders and stop-loss
    name: V2 Trigger
  - description: Managed-agent invocation
    name: V2 Agents
  - description: Portfolio positions and PnL
    name: V2 Portfolio
  - description: User account management
    name: V2 Account
  - description: WebSocket stream discovery, session bootstrap, and channel authorization
    name: V2 WebSocket
  - description: Perpetual trading on Hyperliquid
    name: V2 Perps
  - description: Agent-proposed trade suggestions
    name: V2 Suggestions
paths:
  /api/v2/alpha/tokens/{tokenAddress}/call-context:
    get:
      tags:
        - alpha
      operationId: get_alpha_call_context
      parameters:
        - description: Token address (mint for SVM, contract for EVM)
          in: path
          name: tokenAddress
          required: true
          schema:
            type: string
        - description: 'Maximum signals to return (default: 20, max: 50)'
          in: query
          name: limit
          required: false
          schema:
            format: int32
            minimum: 0
            type: integer
        - description: Pagination cursor from previous response
          in: query
          name: cursor
          required: false
          schema:
            format: int64
            type: integer
        - description: 'CSV filter by source type: discord,telegram,x,trade'
          in: query
          name: sourceFilter
          required: false
          schema:
            type: string
        - description: Include bot-generated signals
          in: query
          name: includeBotSignals
          required: false
          schema:
            type: boolean
        - description: Include message preview and context
          in: query
          name: includeMessageContext
          required: false
          schema:
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResponse_CallContextResult'
          description: Token call context signals
        '401':
          description: Unauthenticated
        '403':
          description: Insufficient scope
      security:
        - bearer_auth: []
components:
  schemas:
    ApiResponse_CallContextResult:
      description: V2 success response envelope
      properties:
        data:
          properties:
            hasMore:
              type: boolean
            nextCursor:
              format: int64
              nullable: true
              type: integer
            signals:
              items:
                $ref: '#/components/schemas/AlphaCallSignalItem'
              type: array
            tokenAddress:
              type: string
            totalSignals:
              format: int32
              type: integer
          required:
            - tokenAddress
            - totalSignals
            - hasMore
            - signals
          type: object
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
          nullable: true
        requestId:
          type: string
      required:
        - data
        - requestId
      type: object
    AlphaCallSignalItem:
      properties:
        caller:
          $ref: '#/components/schemas/AlphaCallCallerItem'
          nullable: true
        contextMessages:
          items:
            $ref: '#/components/schemas/ContextMessageItem'
          nullable: true
          type: array
        isBot:
          type: boolean
        liquidityUsd:
          format: double
          nullable: true
          type: number
        marketCapUsd:
          format: double
          nullable: true
          type: number
        messagePreview:
          nullable: true
          type: string
        platform:
          type: string
        priceUsd:
          format: double
          nullable: true
          type: number
        signalId:
          type: string
        source:
          $ref: '#/components/schemas/AlphaCallSourceDetailItem'
          nullable: true
        timestampMs:
          format: int64
          type: integer
        tradeData:
          $ref: '#/components/schemas/AlphaTradeDataItem'
          nullable: true
      required:
        - signalId
        - timestampMs
        - platform
        - isBot
      type: object
    PaginationInfo:
      description: Page-based pagination info (per RFC)
      properties:
        hasMore:
          type: boolean
        limit:
          format: int32
          minimum: 0
          type: integer
        page:
          format: int32
          minimum: 0
          type: integer
        total:
          format: int32
          minimum: 0
          nullable: true
          type: integer
      required:
        - page
        - limit
        - hasMore
      type: object
    AlphaCallCallerItem:
      properties:
        avatarUrl:
          nullable: true
          type: string
        displayName:
          nullable: true
          type: string
        username:
          nullable: true
          type: string
        verified:
          nullable: true
          type: boolean
      type: object
    ContextMessageItem:
      properties:
        author:
          nullable: true
          type: string
        offset:
          format: int32
          type: integer
        text:
          type: string
        timestampMs:
          format: int64
          type: integer
      required:
        - text
        - timestampMs
        - offset
      type: object
    AlphaCallSourceDetailItem:
      properties:
        channelId:
          nullable: true
          type: string
        channelName:
          nullable: true
          type: string
        guildId:
          nullable: true
          type: string
        messageId:
          nullable: true
          type: string
        serverName:
          nullable: true
          type: string
        topicId:
          format: int32
          nullable: true
          type: integer
        topicTitle:
          nullable: true
          type: string
        tweetId:
          nullable: true
          type: string
      type: object
    AlphaTradeDataItem:
      properties:
        amountNative:
          type: string
        amountUsd:
          type: string
        isBuy:
          type: boolean
        txSignature:
          type: string
        walletAddress:
          type: string
      required:
        - isBuy
        - amountUsd
        - amountNative
        - walletAddress
        - txSignature
      type: object
  securitySchemes:
    bearer_auth:
      bearerFormat: JWT or sk_{keyId}_{secret}
      description: >-
        Use `Authorization: Bearer <jwt>` for user auth or `Authorization:
        Bearer sk_{keyId}_{secret}` for API key auth.
      scheme: bearer
      type: http

````