Card Symbol Objects

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.

Property Type Atn Details
symbol String The plaintext symbol. Often surrounded with curly braces {}. Note that not all symbols are ASCII text (for example, {∞}).
loose_variant String Nullable An alternate version of this symbol, if it is possible to write it without curly braces.
english String An English snippet that describes this symbol. Appropriate for use in alt text or other accessible communication formats.
transposable Boolean True if it is possible to write this symbol “backwards”. For example, the official symbol {U/P} is sometimes written as {P/U} or {P\U} in informal settings. Note that the Scryfall API never writes symbols backwards in other responses. This field is provided for informational purposes.
represents_mana Boolean True if this is a mana symbol.
cmc Decimal Nullable A decimal number representing this symbol’s converted mana cost. Note that mana symbols from funny sets can have fractional converted mana costs.
appears_in_mana_costs Boolean 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.
funny Boolean True if this symbol is only used on funny cards or Un-cards.
colors Colors An array of colors that this symbol represents.
gatherer_alternates String Nullable 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.
svg_uri URI Nullable A URI to an SVG image of this symbol on Scryfall’s CDNs.

Example Request

Retrieve all card symbols

GET https://api.scryfall.com/symbology