EVE Online ESI — Market

naftiko: 1.0.0-alpha2
info:
  label: EVE Online ESI — Market
  description: 'ESI — Market. 11 operations. Lead operation: EVE Online List Open Orders from a Character. Self-contained Naftiko capability covering one EVE Online business surface.'
  tags:
    - EVE Online
    - ESI
    - Market
  created: '2026-05-30'
  modified: '2026-05-30'
binds:
  - namespace: env
    keys:
      EVE_ONLINE_ACCESS_TOKEN: EVE_ONLINE_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: eve-online-market
      baseUri: https://esi.evetech.net/latest
      description: EVE Online ESI — Market business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.EVE_ONLINE_ACCESS_TOKEN}}'
      resources:
        - name: characters-character-id-orders
          path: /characters/{character_id}/orders/
          operations:
            - name: get_characters_character_id_orders
              method: GET
              description: EVE Online List Open Orders from a Character
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-orders-history
          path: /characters/{character_id}/orders/history/
          operations:
            - name: get_characters_character_id_orders_history
              method: GET
              description: EVE Online List Historical Orders by a Character
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-orders
          path: /corporations/{corporation_id}/orders/
          operations:
            - name: get_corporations_corporation_id_orders
              method: GET
              description: EVE Online List Open Orders from a Corporation
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-orders-history
          path: /corporations/{corporation_id}/orders/history/
          operations:
            - name: get_corporations_corporation_id_orders_history
              method: GET
              description: EVE Online List Historical Orders from a Corporation
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: markets-groups
          path: /markets/groups/
          operations:
            - name: get_markets_groups
              method: GET
              description: EVE Online Get Item Groups
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: markets-groups-market-group-id
          path: /markets/groups/{market_group_id}/
          operations:
            - name: get_markets_groups_market_group_id
              method: GET
              description: EVE Online Get Item Group Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: market_group_id
                  in: path
                  type: integer
                  required: true
                  description: An Eve item group ID
        - name: markets-prices
          path: /markets/prices/
          operations:
            - name: get_markets_prices
              method: GET
              description: EVE Online List Market Prices
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: markets-structures-structure-id
          path: /markets/structures/{structure_id}/
          operations:
            - name: get_markets_structures_structure_id
              method: GET
              description: EVE Online List Orders in a Structure
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: structure_id
                  in: path
                  type: integer
                  required: true
                  description: Return orders in this structure
        - name: markets-region-id-history
          path: /markets/{region_id}/history/
          operations:
            - name: get_markets_region_id_history
              method: GET
              description: EVE Online List Historical Market Statistics in a Region
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: region_id
                  in: path
                  type: integer
                  required: true
                  description: Return statistics in this region
                - name: type_id
                  in: query
                  type: integer
                  required: true
                  description: Return statistics for this type
        - name: markets-region-id-orders
          path: /markets/{region_id}/orders/
          operations:
            - name: get_markets_region_id_orders
              method: GET
              description: EVE Online List Orders in a Region
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: order_type
                  in: query
                  type: string
                  required: true
                  description: Filter buy/sell orders, return all orders by default. If you query without type_id, we always return both buy and sell orders
                - name: region_id
                  in: path
                  type: integer
                  required: true
                  description: Return orders in this region
                - name: type_id
                  in: query
                  type: integer
                  required: false
                  description: Return orders only for this type
        - name: markets-region-id-types
          path: /markets/{region_id}/types/
          operations:
            - name: get_markets_region_id_types
              method: GET
              description: EVE Online List Type IDs Relevant to a Market
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: region_id
                  in: path
                  type: integer
                  required: true
                  description: Return statistics in this region
  exposes:
    - type: rest
      namespace: eve-online-market-rest
      port: 8080
      description: REST adapter for EVE Online ESI — Market. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/characters/{character-id}/orders
          name: characters-character-id-orders
          description: REST surface for /characters/{character_id}/orders/.
          operations:
            - method: GET
              name: get_characters_character_id_orders
              description: EVE Online List Open Orders from a Character
              call: eve-online-market.get_characters_character_id_orders
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/orders/history
          name: characters-character-id-orders-history
          description: REST surface for /characters/{character_id}/orders/history/.
          operations:
            - method: GET
              name: get_characters_character_id_orders_history
              description: EVE Online List Historical Orders by a Character
              call: eve-online-market.get_characters_character_id_orders_history
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/orders
          name: corporations-corporation-id-orders
          description: REST surface for /corporations/{corporation_id}/orders/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_orders
              description: EVE Online List Open Orders from a Corporation
              call: eve-online-market.get_corporations_corporation_id_orders
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/orders/history
          name: corporations-corporation-id-orders-history
          description: REST surface for /corporations/{corporation_id}/orders/history/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_orders_history
              description: EVE Online List Historical Orders from a Corporation
              call: eve-online-market.get_corporations_corporation_id_orders_history
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/groups
          name: markets-groups
          description: REST surface for /markets/groups/.
          operations:
            - method: GET
              name: get_markets_groups
              description: EVE Online Get Item Groups
              call: eve-online-market.get_markets_groups
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/groups/{market-group-id}
          name: markets-groups-market-group-id
          description: REST surface for /markets/groups/{market_group_id}/.
          operations:
            - method: GET
              name: get_markets_groups_market_group_id
              description: EVE Online Get Item Group Information
              call: eve-online-market.get_markets_groups_market_group_id
              with:
                market_group_id: rest.market_group_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/prices
          name: markets-prices
          description: REST surface for /markets/prices/.
          operations:
            - method: GET
              name: get_markets_prices
              description: EVE Online List Market Prices
              call: eve-online-market.get_markets_prices
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/structures/{structure-id}
          name: markets-structures-structure-id
          description: REST surface for /markets/structures/{structure_id}/.
          operations:
            - method: GET
              name: get_markets_structures_structure_id
              description: EVE Online List Orders in a Structure
              call: eve-online-market.get_markets_structures_structure_id
              with:
                structure_id: rest.structure_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/{region-id}/history
          name: markets-region-id-history
          description: REST surface for /markets/{region_id}/history/.
          operations:
            - method: GET
              name: get_markets_region_id_history
              description: EVE Online List Historical Market Statistics in a Region
              call: eve-online-market.get_markets_region_id_history
              with:
                region_id: rest.region_id
                type_id: rest.type_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/{region-id}/orders
          name: markets-region-id-orders
          description: REST surface for /markets/{region_id}/orders/.
          operations:
            - method: GET
              name: get_markets_region_id_orders
              description: EVE Online List Orders in a Region
              call: eve-online-market.get_markets_region_id_orders
              with:
                order_type: rest.order_type
                region_id: rest.region_id
                type_id: rest.type_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/markets/{region-id}/types
          name: markets-region-id-types
          description: REST surface for /markets/{region_id}/types/.
          operations:
            - method: GET
              name: get_markets_region_id_types
              description: EVE Online List Type IDs Relevant to a Market
              call: eve-online-market.get_markets_region_id_types
              with:
                region_id: rest.region_id
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: eve-online-market-mcp
      port: 9090
      transport: http
      description: MCP adapter for EVE Online ESI — Market. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: list-open-orders-character
          description: EVE Online List Open Orders from a Character
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_characters_character_id_orders
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: list-historical-orders-character
          description: EVE Online List Historical Orders by a Character
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_characters_character_id_orders_history
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: list-open-orders-corporation
          description: EVE Online List Open Orders from a Corporation
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_corporations_corporation_id_orders
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: list-historical-orders-corporation
          description: EVE Online List Historical Orders from a Corporation
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_corporations_corporation_id_orders_history
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-item-groups
          description: EVE Online Get Item Groups
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_groups
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-item-group-information
          description: EVE Online Get Item Group Information
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_groups_market_group_id
          with:
            market_group_id: tools.market_group_id
          outputParameters:
            - type: object
              mapping: $.
        - name: list-market-prices
          description: EVE Online List Market Prices
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_prices
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: list-orders-structure
          description: EVE Online List Orders in a Structure
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_structures_structure_id
          with:
            structure_id: tools.structure_id
          outputParameters:
            - type: object
              mapping: $.
        - name: list-historical-market-statistics-region
          description: EVE Online List Historical Market Statistics in a Region
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_region_id_history
          with:
            region_id: tools.region_id
            type_id: tools.type_id
          outputParameters:
            - type: object
              mapping: $.
        - name: list-orders-region
          description: EVE Online List Orders in a Region
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_region_id_orders
          with:
            order_type: tools.order_type
            region_id: tools.region_id
            type_id: tools.type_id
          outputParameters:
            - type: object
              mapping: $.
        - name: list-type-ids-relevant-market
          description: EVE Online List Type IDs Relevant to a Market
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-market.get_markets_region_id_types
          with:
            region_id: tools.region_id
          outputParameters:
            - type: object
              mapping: $.