mightstone.services.scryfall.models.Symbol

pydantic model mightstone.services.scryfall.models.Symbol

A Card Symbol object represents an illustrated symbol that may appear in card’s mana cost or Oracle text. Symbols are based on the notation used in the Comprehensive Rules. For more information about how the Scryfall API represents mana and costs, see the colors and costs overview.

Show JSON schema

{
   "title": "Symbol",
   "description": "A Card Symbol object represents an illustrated symbol that may appear in card\u2019s\nmana cost or Oracle text. Symbols are based on the notation used in the\nComprehensive Rules.\nFor more information about how the Scryfall API represents mana and costs, see the\ncolors and costs overview.",
   "type": "object",
   "properties": {
      "object": {
         "const": "card_symbol",
         "enum": [
            "card_symbol"
         ],
         "title": "Object",
         "type": "string"
      },
      "id": {
         "anyOf": [
            {
               "format": "uuid",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Id"
      },
      "symbol": {
         "title": "Symbol",
         "type": "string"
      },
      "loose_variant": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Loose Variant"
      },
      "english": {
         "title": "English",
         "type": "string"
      },
      "transposable": {
         "title": "Transposable",
         "type": "boolean"
      },
      "represents_mana": {
         "title": "Represents Mana",
         "type": "boolean"
      },
      "cmc": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Cmc"
      },
      "appears_in_mana_costs": {
         "title": "Appears In Mana Costs",
         "type": "boolean"
      },
      "funny": {
         "title": "Funny",
         "type": "boolean"
      },
      "colors": {
         "default": [],
         "items": {
            "examples": [
               "U",
               "W"
            ],
            "pattern": [
               "^[WUBRG]$"
            ],
            "title": "Color",
            "type": "string"
         },
         "title": "Colors",
         "type": "array"
      },
      "gatherer_alternates": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Gatherer Alternates"
      },
      "svg_uri": {
         "anyOf": [
            {
               "format": "uri",
               "minLength": 1,
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Svg Uri"
      }
   },
   "required": [
      "object",
      "symbol",
      "english",
      "transposable",
      "represents_mana",
      "appears_in_mana_costs",
      "funny"
   ]
}

Fields:

• appears_in_mana_costs (bool)

• cmc (decimal.Decimal | None)

• colors (List[mightstone.services.scryfall.models.Color])

• english (str)

• funny (bool)

• gatherer_alternates (List[str] | None)

• id (uuid.UUID | None)

• loose_variant (str | None)

• object (Literal['card_symbol'])

• represents_mana (bool)

• svg_uri (pydantic_core._pydantic_core.Url | None)

• symbol (str)

• transposable (bool)

Validators:

• enforce_id » all fields

field appears_in_mana_costs: bool [Required]

True if this symbol appears in a mana cost on any Magic card. For example {20} has this field set to false because {20} only appears in Oracle text, not mana costs.

Validated by:

• enforce_id

field cmc: Decimal | None = None

A decimal number representing this symbol’s converted mana cost. Note that mana symbols from funny sets can have fractional converted mana costs.

Validated by:

• enforce_id

field colors: List[Color] = []

An array of colors that this symbol represents.

Validated by:

• enforce_id

field english: str [Required]

An English snippet that describes this symbol. Appropriate for use in alt text or other accessible communication formats.

Validated by:

• enforce_id

field funny: bool [Required]

True if this symbol is only used on funny cards or Un-cards.

Validated by:

• enforce_id

field gatherer_alternates: List[str] | None = None

An array of plaintext versions of this symbol that Gatherer uses on old cards to describe original printed text. For example: {W} has [“oW”, “ooW”] as alternates.

Validated by:

• enforce_id

field id: UUID | None = None

Validated by:

• enforce_id

field loose_variant: str | None = None

An alternate version of this symbol, if it is possible to write it without curly braces.

Validated by:

• enforce_id

field object: Literal['card_symbol'] [Required]

Validated by:

• enforce_id

field represents_mana: bool [Required]

if this is a mana symbol.

Validated by:

• enforce_id

field svg_uri: Url | None = None

A URI to an SVG image of this symbol on Scryfall’s CDNs.

Validated by:

• enforce_id

field symbol: str [Required]

The plaintext symbol. Often surrounded with curly braces {}. Note that not all symbols are ASCII text (for example, {∞}).

Validated by:

• enforce_id

field transposable: bool [Required]

True if it is possible to write this symbol “backwards”. For example, the official symbol {U/P} is sometimes written as {P/U} or {PU} in informal settings. Note that the Scryfall API never writes symbols backwards in other responses. This field is provided for informational purposes.

Validated by:

• enforce_id

validator enforce_id  »  all fields