EVM API — Token

naftiko: 1.0.0-alpha2
info:
  label: EVM API — Token
  description: 'EVM API — Token. 35 operations. Lead operation: Get bonding tokens by exchange. Self-contained Naftiko capability
    covering one Moralis business surface.'
  tags:
  - Moralis
  - Token
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MORALIS_API_KEY: MORALIS_API_KEY
capability:
  consumes:
  - type: http
    namespace: evm-token
    baseUri: https://deep-index.moralis.io/api/v2.2
    description: EVM API — Token business capability. Self-contained, no shared references.
    resources:
    - name: erc20-exchange-exchangeName-bonding
      path: /erc20/exchange/{exchangeName}/bonding
      operations:
      - name: getbondingtokensbyexchange
        method: GET
        description: Get bonding tokens by exchange
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
          required: true
        - name: exchangeName
          in: path
          type: string
          description: The name of the exchange
          required: true
        - name: limit
          in: query
          type: integer
          description: The maximum number of items to return
        - name: cursor
          in: query
          type: string
          description: The cursor to use for pagination
    - name: erc20-exchange-exchangeName-graduated
      path: /erc20/exchange/{exchangeName}/graduated
      operations:
      - name: getgraduatedtokensbyexchange
        method: GET
        description: Get graduated tokens by exchange
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
          required: true
        - name: exchangeName
          in: path
          type: string
          description: The name of the exchange
          required: true
        - name: limit
          in: query
          type: integer
          description: The maximum number of items to return
        - name: cursor
          in: query
          type: string
          description: The cursor to use for pagination
    - name: erc20-exchange-exchangeName-new
      path: /erc20/exchange/{exchangeName}/new
      operations:
      - name: getnewtokensbyexchange
        method: GET
        description: Get new tokens by exchange
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
          required: true
        - name: exchangeName
          in: path
          type: string
          description: The name of the exchange
          required: true
        - name: limit
          in: query
          type: integer
          description: The maximum number of items to return
        - name: cursor
          in: query
          type: string
          description: The cursor to use for pagination
    - name: erc20-metadata
      path: /erc20/metadata
      operations:
      - name: gettokenmetadata
        method: GET
        description: Get ERC20 token metadata by contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: addresses
          in: query
          type: array
          description: The addresses to get metadata for
          required: true
    - name: erc20-metadata-symbols
      path: /erc20/metadata/symbols
      operations:
      - name: gettokenmetadatabysymbol
        method: GET
        description: Get ERC20 token metadata by symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: symbols
          in: query
          type: array
          description: The symbols to get metadata for
          required: true
    - name: erc20-prices
      path: /erc20/prices
      operations:
      - name: getmultipletokenprices
        method: POST
        description: Get Multiple ERC20 token prices
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: include
          in: query
          type: string
          description: This parameter is now deprecated as percentage change are included by default
        - name: max_token_inactivity
          in: query
          type: number
          description: Exclude tokens inactive for more than the given amount of days
        - name: min_pair_side_liquidity_usd
          in: query
          type: number
          description: Exclude tokens with liquidity less than the specified amount in USD. This parameter refers to the liquidity
            on a single side of the pair.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: erc20-address-price
      path: /erc20/{address}/price
      operations:
      - name: gettokenprice
        method: GET
        description: Get ERC20 token price
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the token contract
          required: true
        - name: exchange
          in: query
          type: string
          description: The factory name or address of the token exchange
        - name: to_block
          in: query
          type: integer
          description: The block number from which the token price should be checked
        - name: include
          in: query
          type: string
          description: This parameter is now deprecated as percentage change are included by default
        - name: max_token_inactivity
          in: query
          type: number
          description: Exclude tokens inactive for more than the given amount of days
        - name: min_pair_side_liquidity_usd
          in: query
          type: number
          description: Exclude tokens with liquidity less than the specified amount in USD. This parameter refers to the liquidity
            on a single side of the pair.
    - name: erc20-address-stats
      path: /erc20/{address}/stats
      operations:
      - name: gettokenstats
        method: GET
        description: Get ERC20 token stats
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address of the erc20 token
          required: true
    - name: erc20-address-swaps
      path: /erc20/{address}/swaps
      operations:
      - name: getswapsbytokenaddress
        method: GET
        description: Get swap transactions by token address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The token address to get transaction for
          required: true
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
        - name: fromBlock
          in: query
          type: integer
          description: The minimum block number from which to get the token transactions
        - name: toBlock
          in: query
          type: string
          description: The block number to get the token transactions from
        - name: fromDate
          in: query
          type: string
          description: The start date from which to get the token transactions (format in seconds or datestring accepted by
            momentjs)
        - name: toDate
          in: query
          type: string
          description: The end date from which to get the token transactions (format in seconds or datestring accepted by
            momentjs)
        - name: transactionTypes
          in: query
          type: string
          description: Array of transaction types. Allowed values are 'buy', 'sell'.
    - name: erc20-address-top-gainers
      path: /erc20/{address}/top-gainers
      operations:
      - name: gettopprofitablewalletpertoken
        method: GET
        description: Get top traders for a given ERC20 token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: address
          in: path
          type: string
          description: The ERC20 token address.
          required: true
        - name: days
          in: query
          type: string
          description: Timeframe in days for which profitability is calculated, Options include 'all', '7', '30' default is
            'all'.
        - name: chain
          in: query
          type: string
          description: The chain to query
    - name: erc20-address-transfers
      path: /erc20/{address}/transfers
      operations:
      - name: gettokentransfers
        method: GET
        description: Get ERC20 token transfers by contract address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from which to get the transfers
        - name: to_block
          in: query
          type: integer
          description: The maximum block number from which to get the transfers.
        - name: from_date
          in: query
          type: string
          description: The start date from which to get the transfers (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: Get transfers up until this date (format in seconds or datestring accepted by momentjs)
        - name: address
          in: path
          type: string
          description: The address of the token contract
          required: true
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
    - name: erc20-tokenAddress-bondingStatus
      path: /erc20/{tokenAddress}/bondingStatus
      operations:
      - name: gettokenbondingstatus
        method: GET
        description: Get the token bonding status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
          required: true
        - name: tokenAddress
          in: path
          type: string
          description: The address of the token
          required: true
    - name: erc20-tokenAddress-holders
      path: /erc20/{tokenAddress}/holders
      operations:
      - name: gettokenholders
        method: GET
        description: Get a holders summary by token address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: tokenAddress
          in: path
          type: string
          description: The token address to get transaction for
          required: true
    - name: erc20-tokenAddress-holders-historical
      path: /erc20/{tokenAddress}/holders/historical
      operations:
      - name: gethistoricaltokenholders
        method: GET
        description: Get timeseries holders data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: tokenAddress
          in: path
          type: string
          description: The token address
          required: true
        - name: fromDate
          in: query
          type: string
          description: The starting date (format in seconds or datestring accepted by momentjs)
          required: true
        - name: toDate
          in: query
          type: string
          description: The ending date (format in seconds or datestring accepted by momentjs)
          required: true
        - name: limit
          in: query
          type: integer
          description: The number of results to return
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page)
        - name: timeFrame
          in: query
          type: string
          description: The time frame to group the data by
          required: true
    - name: erc20-token_address-owners
      path: /erc20/{token_address}/owners
      operations:
      - name: gettokenowners
        method: GET
        description: Get ERC20 token owners by contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: token_address
          in: path
          type: string
          description: The address of the token contract
          required: true
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
    - name: erc20-token_address-pairs
      path: /erc20/{token_address}/pairs
      operations:
      - name: gettokenpairs
        method: GET
        description: Get token pairs by address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token_address
          in: path
          type: string
          description: The address of the token
          required: true
        - name: chain
          in: query
          type: string
          description: The chain to query
          required: true
        - name: limit
          in: query
          type: integer
          description: The number of results to return
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page)
    - name: erc20-token_address-pairs-stats
      path: /erc20/{token_address}/pairs/stats
      operations:
      - name: getaggregatedtokenpairstats
        method: GET
        description: Get aggregated token pair statistics by address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token_address
          in: path
          type: string
          description: The address of the token
          required: true
        - name: chain
          in: query
          type: string
          description: The chain to query
          required: true
    - name: pairs-address-ohlcv
      path: /pairs/{address}/ohlcv
      operations:
      - name: getpaircandlesticks
        method: GET
        description: Get OHLCV by pair address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: address
          in: path
          type: string
          description: The pair address
          required: true
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: timeframe
          in: query
          type: string
          description: The timeframe
          required: true
        - name: currency
          in: query
          type: string
          description: The currency
          required: true
        - name: fromDate
          in: query
          type: string
          description: The starting date (format in seconds or datestring accepted by momentjs)
          required: true
        - name: toDate
          in: query
          type: string
          description: The ending date (format in seconds or datestring accepted by momentjs)
          required: true
        - name: limit
          in: query
          type: integer
          description: The number of results to return
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page)
    - name: pairs-address-snipers
      path: /pairs/{address}/snipers
      operations:
      - name: getsnipersbypairaddress
        method: GET
        description: Get snipers by pair address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The pair address token-transactions are to be retrieved for.
          required: true
        - name: blocksAfterCreation
          in: query
          type: integer
          description: Number of blocks after the creation
    - name: pairs-address-stats
      path: /pairs/{address}/stats
      operations:
      - name: getpairstats
        method: GET
        description: Get stats by pair address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: address
          in: path
          type: string
          description: The pair address
          required: true
        - name: chain
          in: query
          type: string
          description: The chain to query
    - name: pairs-address-swaps
      path: /pairs/{address}/swaps
      operations:
      - name: getswapsbypairaddress
        method: GET
        description: Get swap transactions by pair address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The pair address token-transactions are to be retrieved for.
          required: true
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: fromBlock
          in: query
          type: integer
          description: The minimum block number from which to get the token transactions
        - name: toBlock
          in: query
          type: string
          description: The block number to get the token transactions from
        - name: fromDate
          in: query
          type: string
          description: The start date from which to get the token transactions (format in seconds or datestring accepted by
            momentjs)
        - name: toDate
          in: query
          type: string
          description: The end date from which to get the token transactions (format in seconds or datestring accepted by
            momentjs)
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
        - name: transactionTypes
          in: query
          type: string
          description: Array of transaction types. Allowed values are 'buy', 'sell', 'addLiquidity', 'removeLiquidity'.
    - name: tokens-analytics
      path: /tokens/analytics
      operations:
      - name: getmultipletokenanalytics
        method: POST
        description: Get token analytics for a list of token addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: tokens-analytics-timeseries
      path: /tokens/analytics/timeseries
      operations:
      - name: gettimeseriestokenanalytics
        method: POST
        description: Retrieve timeseries trading stats by token addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: timeframe
          in: query
          type: string
          description: The timeframe to query
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: tokens-categories
      path: /tokens/categories
      operations:
      - name: gettokencategories
        method: GET
        description: Get ERC20 token categories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tokens-search
      path: /tokens/search
      operations:
      - name: searchtokens
        method: GET
        description: Search for tokens based on contract address, pair address, token name or token symbol.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chains
          in: query
          type: string
          description: The chains to query
        - name: query
          in: query
          type: string
          description: The query to search
          required: true
        - name: limit
          in: query
          type: number
          description: The desired page size of the result.
        - name: isVerifiedContract
          in: query
          type: boolean
          description: True to include only verified contracts
        - name: sortBy
          in: query
          type: string
          description: Sort by volume1hDesc, volume24hDesc, liquidityDesc, marketCapDesc
        - name: boostVerifiedContracts
          in: query
          type: boolean
          description: True to boost verified contracts
    - name: tokens-trending
      path: /tokens/trending
      operations:
      - name: gettrendingtokensv2
        method: GET
        description: Get trending tokens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
    - name: tokens-tokenAddress-analytics
      path: /tokens/{tokenAddress}/analytics
      operations:
      - name: gettokenanalytics
        method: GET
        description: Get token analytics by token address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: tokenAddress
          in: path
          type: string
          description: The token address to query
          required: true
    - name: tokens-tokenAddress-score
      path: /tokens/{tokenAddress}/score
      operations:
      - name: gettokenscore
        method: GET
        description: Get token score by token address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: tokenAddress
          in: path
          type: string
          description: The token address to query
          required: true
    - name: tokens-tokenAddress-score-historical
      path: /tokens/{tokenAddress}/score/historical
      operations:
      - name: gethistoricaltokenscore
        method: GET
        description: Get historical token score by token address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: tokenAddress
          in: path
          type: string
          description: The token address to query
          required: true
        - name: timeframe
          in: query
          type: string
          description: The timeframe to query
          required: true
    - name: volume-categories
      path: /volume/categories
      operations:
      - name: getvolumestatsbycategory
        method: GET
        description: Get trading stats by categories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
    - name: volume-chains
      path: /volume/chains
      operations:
      - name: getvolumestatsbychain
        method: GET
        description: Get trading stats by chain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: volume-timeseries
      path: /volume/timeseries
      operations:
      - name: gettimeseriesvolume
        method: GET
        description: Retrieve timeseries trading stats by chain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: timeframe
          in: query
          type: string
          description: The timeframe to query
          required: true
    - name: volume-timeseries-categoryId
      path: /volume/timeseries/{categoryId}
      operations:
      - name: gettimeseriesvolumebycategory
        method: GET
        description: Retrieve timeseries trading stats by category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: timeframe
          in: query
          type: string
          description: The timeframe to query
          required: true
        - name: categoryId
          in: path
          type: string
          description: The category id
          required: true
    - name: address-erc20
      path: /{address}/erc20
      operations:
      - name: getwallettokenbalances
        method: GET
        description: Get ERC20 token balances by wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: address
          in: path
          type: string
          description: The address from which token balances will be checked
          required: true
        - name: to_block
          in: query
          type: number
          description: The block number up to which the balances will be checked.
        - name: token_addresses
          in: query
          type: array
          description: The addresses to get balances for (optional)
        - name: exclude_spam
          in: query
          type: boolean
          description: Exclude spam tokens from the result
    - name: address-erc20-transfers
      path: /{address}/erc20/transfers
      operations:
      - name: getwallettokentransfers
        method: GET
        description: Get ERC20 token transfers by wallet address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chain
          in: query
          type: string
          description: The chain to query
        - name: from_block
          in: query
          type: integer
          description: The minimum block number from which to get the transactions
        - name: to_block
          in: query
          type: integer
          description: The maximum block number from which to get the transactions.
        - name: from_date
          in: query
          type: string
          description: The start date from which to get the transactions (format in seconds or datestring accepted by momentjs)
        - name: to_date
          in: query
          type: string
          description: Get the transactions up to this date (format in seconds or datestring accepted by momentjs)
        - name: address
          in: path
          type: string
          description: The address of the wallet
          required: true
        - name: contract_addresses
          in: query
          type: array
          description: List of contract addresses of transfers
        - name: limit
          in: query
          type: integer
          description: The desired page size of the result.
        - name: order
          in: query
          type: string
          description: The order of the result, in ascending (ASC) or descending (DESC)
        - name: cursor
          in: query
          type: string
          description: The cursor returned in the previous response (used for getting the next page).
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.MORALIS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: evm-token-rest
    port: 8080
    description: REST adapter for EVM API — Token. One 

# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/moralis/refs/heads/main/capabilities/evm-token.yaml