EVM API — Market Data

naftiko: 1.0.0-alpha2
info:
  label: EVM API — Market Data
  description: 'EVM API — Market Data. 6 operations. Lead operation: Get top ERC20 tokens by price movements (winners and
    losers). Self-contained Naftiko capability covering one Moralis business surface.'
  tags:
  - Moralis
  - Market Data
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MORALIS_API_KEY: MORALIS_API_KEY
capability:
  consumes:
  - type: http
    namespace: evm-market-data
    baseUri: https://deep-index.moralis.io/api/v2.2
    description: EVM API — Market Data business capability. Self-contained, no shared references.
    resources:
    - name: market-data-erc20s-top-movers
      path: /market-data/erc20s/top-movers
      operations:
      - name: gettoperc20tokensbypricemovers
        method: GET
        description: Get top ERC20 tokens by price movements (winners and losers)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: market-data-erc20s-top-tokens
      path: /market-data/erc20s/top-tokens
      operations:
      - name: gettoperc20tokensbymarketcap
        method: GET
        description: Get top ERC20 tokens by market cap
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: market-data-global-market-cap
      path: /market-data/global/market-cap
      operations:
      - name: gettopcryptocurrenciesbymarketcap
        method: GET
        description: Get top crypto currencies by market cap
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: market-data-global-volume
      path: /market-data/global/volume
      operations:
      - name: gettopcryptocurrenciesbytradingvolume
        method: GET
        description: Get top crypto currencies by trading volume
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: market-data-nfts-hottest-collections
      path: /market-data/nfts/hottest-collections
      operations:
      - name: gethottestnftcollectionsbytradingvolume
        method: GET
        description: Get top NFT collections by trading volume
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: market-data-nfts-top-collections
      path: /market-data/nfts/top-collections
      operations:
      - name: gettopnftcollectionsbymarketcap
        method: GET
        description: Get top NFT collections by market cap
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.MORALIS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: evm-market-data-rest
    port: 8080
    description: REST adapter for EVM API — Market Data. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/market-data/erc20s/top-movers
      name: market-data-erc20s-top-movers
      description: REST surface for market-data-erc20s-top-movers.
      operations:
      - method: GET
        name: gettoperc20tokensbypricemovers
        description: Get top ERC20 tokens by price movements (winners and losers)
        call: evm-market-data.gettoperc20tokensbypricemovers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/market-data/erc20s/top-tokens
      name: market-data-erc20s-top-tokens
      description: REST surface for market-data-erc20s-top-tokens.
      operations:
      - method: GET
        name: gettoperc20tokensbymarketcap
        description: Get top ERC20 tokens by market cap
        call: evm-market-data.gettoperc20tokensbymarketcap
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/market-data/global/market-cap
      name: market-data-global-market-cap
      description: REST surface for market-data-global-market-cap.
      operations:
      - method: GET
        name: gettopcryptocurrenciesbymarketcap
        description: Get top crypto currencies by market cap
        call: evm-market-data.gettopcryptocurrenciesbymarketcap
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/market-data/global/volume
      name: market-data-global-volume
      description: REST surface for market-data-global-volume.
      operations:
      - method: GET
        name: gettopcryptocurrenciesbytradingvolume
        description: Get top crypto currencies by trading volume
        call: evm-market-data.gettopcryptocurrenciesbytradingvolume
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/market-data/nfts/hottest-collections
      name: market-data-nfts-hottest-collections
      description: REST surface for market-data-nfts-hottest-collections.
      operations:
      - method: GET
        name: gethottestnftcollectionsbytradingvolume
        description: Get top NFT collections by trading volume
        call: evm-market-data.gethottestnftcollectionsbytradingvolume
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/market-data/nfts/top-collections
      name: market-data-nfts-top-collections
      description: REST surface for market-data-nfts-top-collections.
      operations:
      - method: GET
        name: gettopnftcollectionsbymarketcap
        description: Get top NFT collections by market cap
        call: evm-market-data.gettopnftcollectionsbymarketcap
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: evm-market-data-mcp
    port: 9090
    transport: http
    description: MCP adapter for EVM API — Market Data. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: get-top-erc20-tokens-price
      description: Get top ERC20 tokens by price movements (winners and losers)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: evm-market-data.gettoperc20tokensbypricemovers
      outputParameters:
      - type: object
        mapping: $.
    - name: get-top-erc20-tokens-market
      description: Get top ERC20 tokens by market cap
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: evm-market-data.gettoperc20tokensbymarketcap
      outputParameters:
      - type: object
        mapping: $.
    - name: get-top-crypto-currencies-market
      description: Get top crypto currencies by market cap
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: evm-market-data.gettopcryptocurrenciesbymarketcap
      outputParameters:
      - type: object
        mapping: $.
    - name: get-top-crypto-currencies-trading
      description: Get top crypto currencies by trading volume
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: evm-market-data.gettopcryptocurrenciesbytradingvolume
      outputParameters:
      - type: object
        mapping: $.
    - name: get-top-nft-collections-trading
      description: Get top NFT collections by trading volume
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: evm-market-data.gethottestnftcollectionsbytradingvolume
      outputParameters:
      - type: object
        mapping: $.
    - name: get-top-nft-collections-market
      description: Get top NFT collections by market cap
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: evm-market-data.gettopnftcollectionsbymarketcap
      outputParameters:
      - type: object
        mapping: $.