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

# Get Token Security

> Retrieve comprehensive security information for a token including contract holdings, burned tokens, trading fees, transfer restrictions, holder distribution analysis, contract risk indicators, and AI-powered static code analysis for verified EVM contracts.



## OpenAPI

````yaml get /2/token/security
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /2/token/security:
    get:
      tags:
        - V2 - Token
      summary: Get Token Security Information
      parameters:
        - schema:
            type: string
            description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
          required: false
          description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
          name: chainId
          in: query
        - schema:
            type: string
            description: Token contract address
          required: true
          description: Token contract address
          name: address
          in: query
      responses:
        '200':
          description: >-
            Token security response with holdings, fees, and transfer
            restrictions
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      address:
                        type: string
                      chainId:
                        type: string
                      contractHoldingsPercentage:
                        type: number
                        nullable: true
                      contractBalanceRaw:
                        type: string
                        nullable: true
                      burnedHoldingsPercentage:
                        type: number
                        nullable: true
                      totalBurnedBalanceRaw:
                        type: string
                        nullable: true
                      buyFeePercentage:
                        type: number
                      sellFeePercentage:
                        type: number
                      transferFeePercentage:
                        type: number
                      maxWalletAmountRaw:
                        type: string
                        nullable: true
                      maxSellAmountRaw:
                        type: string
                        nullable: true
                      maxBuyAmountRaw:
                        type: string
                        nullable: true
                      maxTransferAmountRaw:
                        type: string
                        nullable: true
                      isLaunchpadToken:
                        type: boolean
                        nullable: true
                      top10HoldingsPercentage:
                        type: number
                        nullable: true
                      top50HoldingsPercentage:
                        type: number
                        nullable: true
                      top100HoldingsPercentage:
                        type: number
                        nullable: true
                      top200HoldingsPercentage:
                        type: number
                        nullable: true
                      isMintable:
                        type: boolean
                        nullable: true
                      isFreezable:
                        type: boolean
                        nullable: true
                      proTraderVolume24hPercentage:
                        type: number
                        nullable: true
                      transferPausable:
                        type: boolean
                        nullable: true
                      isBlacklisted:
                        type: boolean
                        nullable: true
                      isHoneypot:
                        type: boolean
                        nullable: true
                      isNotOpenSource:
                        type: boolean
                        nullable: true
                      renounced:
                        type: boolean
                        nullable: true
                      locked:
                        type: string
                        nullable: true
                      isWhitelisted:
                        type: boolean
                        nullable: true
                      balanceMutable:
                        type: boolean
                        nullable: true
                      lowLiquidity:
                        type: string
                        nullable: true
                      burnRate:
                        type: string
                        nullable: true
                      modifyableTax:
                        type: boolean
                        nullable: true
                      selfDestruct:
                        type: boolean
                        nullable: true
                      staticAnalysisStatus:
                        type: string
                        nullable: true
                        enum:
                          - completed
                          - pending
                          - not_available
                          - insufficient_liquidity
                          - not_evm
                      staticAnalysisDate:
                        type: string
                        nullable: true
                      liquidityBurnPercentage:
                        type: number
                        nullable: true
                      securityScore:
                        type: number
                        nullable: true
                      securityScoreUpdatedAt:
                        type: string
                        nullable: true
                      securityScoreDetails:
                        oneOf:
                          - type: object
                            properties:
                              version:
                                type: number
                                enum:
                                  - 3
                              base:
                                type: number
                              killed:
                                type: boolean
                              killReason:
                                type: string
                                nullable: true
                              hardKill:
                                type: object
                                nullable: true
                                properties:
                                  id:
                                    type: string
                                  reason:
                                    type: string
                                  description:
                                    type: string
                                  meta:
                                    type: object
                                    additionalProperties:
                                      nullable: true
                                required:
                                  - id
                                  - reason
                                  - description
                                  - meta
                              checks:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: integer
                                      minimum: 1
                                      maximum: 15
                                    name:
                                      type: string
                                    kind:
                                      type: string
                                      enum:
                                        - penalty
                                        - bonus
                                    delta:
                                      type: number
                                    rawDelta:
                                      type: number
                                    cap:
                                      type: number
                                    cexAdjusted:
                                      type: boolean
                                    meta:
                                      type: object
                                      additionalProperties:
                                        nullable: true
                                  required:
                                    - id
                                    - name
                                    - kind
                                    - delta
                                    - rawDelta
                                    - cap
                                    - cexAdjusted
                                    - meta
                              hardFloors:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    description:
                                      type: string
                                    maxScore:
                                      type: number
                                    meta:
                                      type: object
                                      additionalProperties:
                                        nullable: true
                                  required:
                                    - id
                                    - description
                                    - maxScore
                                    - meta
                              cexMultiplier:
                                type: number
                              tier1Cexes:
                                type: array
                                items:
                                  type: string
                              inputs:
                                type: object
                                properties:
                                  chainId:
                                    type: string
                                  address:
                                    type: string
                                  liquidityUSD:
                                    type: number
                                  liquidityMaxUSD:
                                    type: number
                                  marketCapUSD:
                                    type: number
                                  volume24hUSD:
                                    type: number
                                  organicVolume24hUSD:
                                    type: number
                                  organicRatio:
                                    type: number
                                    nullable: true
                                  priceChange24hPct:
                                    type: number
                                  holdersCount:
                                    type: number
                                  top10HoldingsPct:
                                    type: number
                                  lpHoldingsPct:
                                    type: number
                                  bundlersCount:
                                    type: number
                                  bundlersHoldingsPct:
                                    type: number
                                  insidersCount:
                                    type: number
                                  insidersHoldingsPct:
                                    type: number
                                  snipersCount:
                                    type: number
                                  snipersHoldingsPct:
                                    type: number
                                  devHoldingsPct:
                                    type: number
                                  proTradersCount:
                                    type: number
                                  proTradersHoldingsPct:
                                    type: number
                                  deployerTokensCount:
                                    type: number
                                  deployerMigrationsCount:
                                    type: number
                                  migrationRate:
                                    type: number
                                    nullable: true
                                  tier1Cexes:
                                    type: array
                                    items:
                                      type: string
                                  cexMultiplier:
                                    type: number
                                  ageDays:
                                    type: number
                                    nullable: true
                                  bondedAgeDays:
                                    type: number
                                    nullable: true
                                  securityFlags:
                                    type: object
                                    nullable: true
                                    additionalProperties:
                                      nullable: true
                                  securitySourcesAvailable:
                                    type: array
                                    items:
                                      type: string
                                required:
                                  - chainId
                                  - address
                                  - liquidityUSD
                                  - marketCapUSD
                                  - volume24hUSD
                                  - organicVolume24hUSD
                                  - organicRatio
                                  - priceChange24hPct
                                  - holdersCount
                                  - top10HoldingsPct
                                  - lpHoldingsPct
                                  - bundlersCount
                                  - bundlersHoldingsPct
                                  - insidersCount
                                  - insidersHoldingsPct
                                  - snipersCount
                                  - snipersHoldingsPct
                                  - devHoldingsPct
                                  - proTradersCount
                                  - proTradersHoldingsPct
                                  - deployerTokensCount
                                  - deployerMigrationsCount
                                  - migrationRate
                                  - tier1Cexes
                                  - cexMultiplier
                                  - ageDays
                                  - bondedAgeDays
                                  - securityFlags
                                  - securitySourcesAvailable
                              rawScore:
                                type: number
                              finalScore:
                                type: number
                              tier:
                                type: string
                                enum:
                                  - Very Low
                                  - Low
                                  - Moderate
                                  - High
                                  - Critical
                              computedAt:
                                type: string
                            required:
                              - version
                              - base
                              - killed
                              - killReason
                              - hardKill
                              - checks
                              - hardFloors
                              - cexMultiplier
                              - tier1Cexes
                              - inputs
                              - rawScore
                              - finalScore
                              - tier
                              - computedAt
                          - type: object
                            properties:
                              version:
                                type: number
                                enum:
                                  - 2
                              base:
                                type: number
                              rules:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    label:
                                      type: string
                                    bucket:
                                      type: string
                                      enum:
                                        - market
                                        - decentralization
                                        - aiCode
                                        - spl
                                    delta:
                                      type: number
                                    meta:
                                      type: object
                                      additionalProperties:
                                        nullable: true
                                  required:
                                    - id
                                    - label
                                    - bucket
                                    - delta
                                    - meta
                              caps:
                                type: object
                                properties:
                                  market:
                                    type: object
                                    properties:
                                      raw:
                                        type: number
                                      applied:
                                        type: number
                                      max:
                                        type: number
                                    required:
                                      - raw
                                      - applied
                                      - max
                                  decentralization:
                                    type: object
                                    properties:
                                      raw:
                                        type: number
                                      applied:
                                        type: number
                                      max:
                                        type: number
                                    required:
                                      - raw
                                      - applied
                                      - max
                                  aiCode:
                                    type: object
                                    properties:
                                      raw:
                                        type: number
                                      applied:
                                        type: number
                                      max:
                                        type: number
                                    required:
                                      - raw
                                      - applied
                                      - max
                                  spl:
                                    type: object
                                    properties:
                                      raw:
                                        type: number
                                      applied:
                                        type: number
                                      max:
                                        type: number
                                    required:
                                      - raw
                                      - applied
                                      - max
                                required:
                                  - market
                                  - decentralization
                                  - aiCode
                                  - spl
                              inputs:
                                type: object
                                properties:
                                  chainId:
                                    type: string
                                  address:
                                    type: string
                                  liquidityUSD:
                                    type: number
                                  marketCapUSD:
                                    type: number
                                  volume24hUSD:
                                    type: number
                                  organicVolume24hUSD:
                                    type: number
                                  organicRatio:
                                    type: number
                                    nullable: true
                                  priceChange24hPct:
                                    type: number
                                  hl24Pct:
                                    type: number
                                    nullable: true
                                  holdersCount:
                                    type: number
                                  deployerTokensCount:
                                    type: number
                                  top10HoldingsPct:
                                    type: number
                                  lpHoldingsPct:
                                    type: number
                                  capBand:
                                    type: string
                                    nullable: true
                                    enum:
                                      - MICROCAP
                                      - SMALL_CAP
                                      - MID_LARGE_CAP
                                  securityFlags:
                                    type: object
                                    nullable: true
                                    additionalProperties:
                                      nullable: true
                                  securitySourcesAvailable:
                                    type: array
                                    items:
                                      type: string
                                required:
                                  - chainId
                                  - address
                                  - liquidityUSD
                                  - marketCapUSD
                                  - volume24hUSD
                                  - organicVolume24hUSD
                                  - organicRatio
                                  - priceChange24hPct
                                  - hl24Pct
                                  - holdersCount
                                  - deployerTokensCount
                                  - top10HoldingsPct
                                  - lpHoldingsPct
                                  - capBand
                                  - securityFlags
                                  - securitySourcesAvailable
                              finalScore:
                                type: number
                              tier:
                                type: string
                                enum:
                                  - Very Low
                                  - Low
                                  - Moderate
                                  - High
                                  - Critical
                              computedAt:
                                type: string
                            required:
                              - version
                              - base
                              - rules
                              - caps
                              - inputs
                              - finalScore
                              - tier
                              - computedAt
                          - nullable: true
                      liquidityAnalysis:
                        type: array
                        nullable: true
                        items:
                          type: object
                          properties:
                            poolAddress:
                              type: string
                            poolType:
                              type: string
                            burnedPercentage:
                              type: number
                            lockedPercentage:
                              type: number
                            contractPercentage:
                              type: number
                            unlockedPercentage:
                              type: number
                            topHolders:
                              type: array
                              items:
                                type: object
                                properties:
                                  address:
                                    type: string
                                  percentage:
                                    type: number
                                  type:
                                    type: string
                                    enum:
                                      - burned
                                      - locked
                                      - contract
                                      - unlocked
                                  protocol:
                                    type: string
                                    nullable: true
                                required:
                                  - address
                                  - percentage
                                  - type
                                  - protocol
                          required:
                            - poolAddress
                            - poolType
                            - burnedPercentage
                            - lockedPercentage
                            - contractPercentage
                            - unlockedPercentage
                            - topHolders
                    required:
                      - address
                      - chainId
                      - contractHoldingsPercentage
                      - contractBalanceRaw
                      - burnedHoldingsPercentage
                      - totalBurnedBalanceRaw
                      - buyFeePercentage
                      - sellFeePercentage
                      - transferFeePercentage
                      - maxWalletAmountRaw
                      - maxSellAmountRaw
                      - maxBuyAmountRaw
                      - maxTransferAmountRaw
                      - isLaunchpadToken
                      - top10HoldingsPercentage
                      - top50HoldingsPercentage
                      - top100HoldingsPercentage
                      - top200HoldingsPercentage
                      - isMintable
                      - isFreezable
                      - proTraderVolume24hPercentage
                      - transferPausable
                      - isBlacklisted
                      - isHoneypot
                      - isNotOpenSource
                      - renounced
                      - locked
                      - isWhitelisted
                      - balanceMutable
                      - lowLiquidity
                      - burnRate
                      - modifyableTax
                      - selfDestruct
                      - staticAnalysisStatus
                      - staticAnalysisDate
                      - liquidityBurnPercentage
                      - securityScore
                      - securityScoreUpdatedAt
                      - securityScoreDetails
                      - liquidityAnalysis
                  hostname:
                    type: string
                required:
                  - data

````