luniumpay-com Mesh · Discovery API

openapi: 3.2.0
info:
  title: Luniumpay Com Mesh · Discovery API
  version: 1.48.0
  contact:
    name: Lunium
    email: contato@luniumpay.com
    url: https://luniumpay.com/integrar?utm_source=openapi&utm_medium=spec
  x-documentation-revision: 2026-09-17.4
  x-lunium-partners:
    name: Lunium Partners — comunidade oficial de integradores
    url: https://t.me/+FerOZMRRP_g5MDk5
    description: Avisos operacionais, mudanças de contrato e troca entre parceiros. Nunca publique uma chave de API no grupo.
  description: 'Operations tagged Mesh · Discovery across 2 of this provider''s published API definitions: api.json, luniumpay-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.luniumpay.com
  description: Produção
security:
- ApiKey: []
tags:
- name: Mesh · Discovery
  description: Como um agente descobre a Lunium e o que ela faz, sem falar com ninguem.
paths:
  /mesh:
    get:
      tags:
      - Mesh · Discovery
      operationId: meshDiscovery
      summary: Tudo que um agente precisa saber antes de integrar
      description: 'Um GET responde: quem somos, o que liquidamos, quais ativos e redes, todos os endpoints, como obter chave, como chegar a producao, os limites e os schemas. Nao exige credencial.'
      security: []
      x-lunium-agent-safe: true
      x-lunium-environment: any
      responses:
        '200':
          description: O documento de descoberta.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeshDiscovery'
    servers:
    - url: https://api.luniumpay.com
      description: Produção
  /mesh/graph:
    get:
      tags:
      - Mesh · Discovery
      operationId: meshGraph
      summary: Grafo de agentes do Mesh
      description: 'Quem está na rede e quem trouxe quem: lista os agentes públicos (sem segredo) e agrega totais da rede. Não exige credencial.'
      security: []
      x-lunium-agent-safe: true
      x-lunium-environment: any
      responses:
        '200':
          description: Estatísticas e agentes públicos.
          content:
            application/json:
              schema:
                type: object
                required:
                - stats
                - agents
                properties:
                  stats:
                    type: object
                    additionalProperties: true
                  agents:
                    type: array
                    items:
                      type: object
                      required:
                      - agent_id
                      - name
                      - status
                      - capabilities
                      properties:
                        agent_id:
                          type: string
                        name:
                          type: string
                        status:
                          type: string
                        referred_by:
                          type:
                          - string
                          - 'null'
                        capabilities:
                          type: array
                          items:
                            type: string
    servers:
    - url: https://api.luniumpay.com
      description: Produção
components:
  schemas:
    Capability:
      type: object
      description: O que a Lunium faz, descrito por ATRIBUTO e nao por nome interno — para um agente casar a propria intencao sem conhecer nosso vocabulario.
      properties:
        descricao:
          type: string
        intent:
          type: array
          items:
            type: string
          example:
          - sell_crypto
          - receive_fiat
          - offramp
          - cash_out
        input_assets:
          type: array
          items:
            type: string
          example:
          - USDT
        input_networks:
          type: array
          items:
            type: string
          example:
          - polygon
        output_currencies:
          type: array
          items:
            type: string
          example:
          - BRL
        payment_rails:
          type: array
          items:
            type: string
          example:
          - PIX
        endpoint:
          type: string
          example: /cash-outs
        direction:
          type: string
          example: crypto->fiat
        settlement_speed:
          type: string
          enum:
          - seconds
          - minutes
    MeshDiscovery:
      type: object
      description: Documento unico que responde o que um agente pergunta antes de integrar. Gerado da configuracao viva — nao pode divergir do que a API faz.
      properties:
        quem_somos:
          type: object
        como_falar_comigo:
          type: object
          description: REST, OpenAPI, MCP, A2A e Mesh.
        capacidades:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Capability'
        como_escolher_capacidade:
          type: object
          description: Indice invertido intencao -> capacidades, mais como filtrar por atributo.
          properties:
            por_intencao:
              type: object
              additionalProperties:
                type: array
                items:
                  type: string
        execucao:
          type: object
          description: 'Por capacidade: endpoint, campos obrigatorios e exemplo pronto.'
        ativos_e_redes:
          type: object
        limites:
          type: object
        como_comecar:
          type: object
        regra_de_seguranca:
          type: object
        atribuicao:
          type: object
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Chave criada em `POST /keys`. Aparece uma única vez — guarde no momento da criação.
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your key. `lun_test_…` is sandbox (moves nothing); `lun_…` is production.
externalDocs:
  description: Mínimos e máximos por moeda e rede
  url: https://docs.luniumpay.com/minimos
x-refined-from:
- api.json
- luniumpay-com-openapi.json