Fractal Metagame Service API

openapi: 3.2.0
info:
  title: Fractal Metagame Service API
  version: '1.0'
servers:
- url: https://api.fractal.is
tags:
- name: MetagameService
paths:
  /sdk/v1/metagame/flakes_summary:
    get:
      summary: getFlakesSummary
      description: 'Obtain a summary of Fractal NFTs (the snowflakes) held by the user.

        Requires user access token with the following scope: items:read.


        The attributes field will give you the maximum and minimum values of the attributes given all the NFTs. The factions field gives a count of the number of flakes in each faction.

        Hence giving benefits to Hexa holders simply amounts to checking that factions.Hexa >= 1. Giving benefits to any Fractal NFT holder amounts to check that at least one of the faction is non-zero.


        In terms of rarirty for factions Hexa > Penta > Quad > Tri.


        The metagame allows participant to power up their Fractals, so one would typically check the Power.max >= threshold.'
      operationId: GetFlakesSummary
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/fractal.sdk.metagame.GetFlakesSummaryResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/google.rpc.Status'
      tags:
      - MetagameService
      security:
      - bearerAuth:
        - items:read
components:
  schemas:
    fractal.sdk.metagame.GetFlakesSummaryResponse.MinMax:
      type: object
      properties:
        min:
          type: string
        max:
          type: string
    google.protobuf.Any:
      type: object
      properties:
        '@type':
          type: string
      additionalProperties: {}
    fractal.sdk.metagame.GetFlakesSummaryResponse:
      type: object
      properties:
        attributes:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/fractal.sdk.metagame.GetFlakesSummaryResponse.MinMax'
        factions:
          type: object
          additionalProperties:
            type: integer
            format: int32
      required:
      - attributes
      - factions
    google.rpc.Status:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/google.protobuf.Any'
  securitySchemes:
    projectApiToken:
      type: apiKey
      description: 'Project API Token. Example: ''Authorization: Bearer <token>''

        see https://developers.fractal.is/server-auth'
      name: Authorization
      in: header
    bearerAuth:
      type: apiKey
      description: 'example: ''Authorization: Bearer <token>'''
      name: Authorization
      in: header
x-provenance:
  method: searched
  source: https://reference.fractal.is/reference
  harvested: '2026-10-22'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://reference.fractal.is/reference/authorize.md
  - https://reference.fractal.is/reference/batchcreatescores.md
  - https://reference.fractal.is/reference/createevmminttransaction.md
  - https://reference.fractal.is/reference/createitemminttransaction.md
  - https://reference.fractal.is/reference/createpolygonitemminttransaction.md
  - https://reference.fractal.is/reference/createscore.md
  - https://reference.fractal.is/reference/createsolanaminttransaction.md
  - https://reference.fractal.is/reference/createtournamentscore.md
  - https://reference.fractal.is/reference/evmmint.md
  - https://reference.fractal.is/reference/generateburntokentransaction.md
  - https://reference.fractal.is/reference/generateuploadfileurl.md
  - https://reference.fractal.is/reference/getcoins.md
  - https://reference.fractal.is/reference/getcollectionitems.md
  - https://reference.fractal.is/reference/getcollections.md
  - https://reference.fractal.is/reference/getexternaluserscores.md
  - https://reference.fractal.is/reference/getflakessummary.md
  - https://reference.fractal.is/reference/getforsaleitems.md
  - https://reference.fractal.is/reference/getinfo.md
  - https://reference.fractal.is/reference/getitems.md
  - https://reference.fractal.is/reference/getlatestscores.md
  - https://reference.fractal.is/reference/getscore.md
  - https://reference.fractal.is/reference/getsignedresult.md
  - https://reference.fractal.is/reference/gettokenidminted.md
  - https://reference.fractal.is/reference/gettokenlistings.md
  - https://reference.fractal.is/reference/gettokenmetadata.md
  - https://reference.fractal.is/reference/gettransactionstatus.md
  - https://reference.fractal.is/reference/getuserscorestotal.md
  - https://reference.fractal.is/reference/getwalletitems.md
  - https://reference.fractal.is/reference/isforsale.md
  - https://reference.fractal.is/reference/polygonsetmaxsupply.md
  - https://reference.fractal.is/reference/refreshmetadata.md
  - https://reference.fractal.is/reference/solanamint.md
  - https://reference.fractal.is/reference/syncitemmetadata.md
  - https://reference.fractal.is/reference/tokenbuytransaction.md
  - https://reference.fractal.is/reference/tokencancelselltransaction.md
  - https://reference.fractal.is/reference/tokenselltransaction.md
  - https://reference.fractal.is/reference/updateitemmetadata.md
  - https://reference.fractal.is/reference/upgrade.md
  merge:
    pages: 38
    deduped: 124
    conflicts_kept_first: 0