Colors and Costs
While Magic cards can represent costs and colors using printed symbols, the Comprehensive Rules and Scryfall’s API use a text representation of these values.
Color Arrays
Whenever the API presents set of Magic colors, the field will be an
array that uses the uppercase, single-character abbreviations for those colors.
For example, ["W","U"]
represents something that is both white and blue.
Colorless sources are denoted with an empty array []
Common places were you might see this kind of array are a Card object’s
colors
and color_identity
. When a color field is null
or missing, it
implies that that information is not pertinent for the current object.
It does not imply that the object is colorless.
Color arrays are not guaranteed to be in a particular order.
A list of color representations is provided below:
Abbr. | Color | Basic Land | Mana Symbol | Examples |
---|---|---|---|---|
|
White |
{W} | ||
|
Blue |
{U} | ||
|
Black |
{B} | ||
|
Red |
{R} | ||
|
Green |
{G} |
Mana Costs and Other Symbology
Whenever the API presents mana costs and other card symbols,
it does so using the official plaintext notation for that symbol set forth
in the Comprehensive Rules.
For example, “{2/W}, {T}” is written as {2/W}, {T}
.
An exhaustive list of all symbology is provided below. You can also retrieve this information programmatically using the /symbology method.
Note that some symbols use UTF-8 characters outside the ASCII range.
Symbol | Printed | Mana? | Mana Value | Description | Examples |
---|---|---|---|---|---|
|
{T} | No |
Tap this permanent |
||
|
{Q} | No |
Untap this permanent |
||
|
{E} | No |
An energy counter |
||
|
{P} | No |
Modal budget pawprint |
||
|
{PW} | No |
Planeswalker |
||
|
{CHAOS} | No |
Chaos |
||
|
{A} | No |
An acorn counter |
||
|
{TK} | No |
A ticket counter |
||
|
{X} | Yes |
|
X generic mana |
|
|
{Y} | Yes |
|
Y generic mana |
|
|
{Z} | Yes |
|
Z generic mana |
|
|
{0} | Yes |
|
Zero mana |
|
|
{½} | Yes |
|
One-half generic mana |
|
|
{1} | Yes |
|
One generic mana |
|
|
{2} | Yes |
|
Two generic mana |
|
|
{3} | Yes |
|
Three generic mana |
|
|
{4} | Yes |
|
Four generic mana |
|
|
{5} | Yes |
|
Five generic mana |
|
|
{6} | Yes |
|
Six generic mana |
|
|
{7} | Yes |
|
Seven generic mana |
|
|
{8} | Yes |
|
Eight generic mana |
|
|
{9} | Yes |
|
Nine generic mana |
|
|
{10} | Yes |
|
Ten generic mana |
|
|
{11} | Yes |
|
Eleven generic mana |
|
|
{12} | Yes |
|
Twelve generic mana |
|
|
{13} | Yes |
|
Thirteen generic mana |
|
|
{14} | Yes |
|
Fourteen generic mana |
|
|
{15} | Yes |
|
Fifteen generic mana |
|
|
{16} | Yes |
|
Sixteen generic mana |
|
|
{17} | Yes |
|
Seventeen generic mana |
|
|
{18} | Yes |
|
Eighteen generic mana |
|
|
{19} | Yes |
|
Nineteen generic mana |
|
|
{20} | Yes |
|
Twenty generic mana |
|
|
{100} | Yes |
|
One hundred generic mana |
|
|
{1000000} | Yes |
|
One million generic mana |
|
|
{∞} | Yes |
|
Infinite generic mana |
|
|
{W/U} | Yes |
|
One white or blue mana |
|
|
{W/B} | Yes |
|
One white or black mana |
|
|
{B/R} | Yes |
|
One black or red mana |
|
|
{B/G} | Yes |
|
One black or green mana |
|
|
{U/B} | Yes |
|
One blue or black mana |
|
|
{U/R} | Yes |
|
One blue or red mana |
|
|
{R/G} | Yes |
|
One red or green mana |
|
|
{R/W} | Yes |
|
One red or white mana |
|
|
{G/W} | Yes |
|
One green or white mana |
|
|
{G/U} | Yes |
|
One green or blue mana |
|
|
{B/G/P} | Yes |
|
One black mana, one green mana, or 2 life |
|
|
{B/R/P} | Yes |
|
One black mana, one red mana, or 2 life |
|
|
{G/U/P} | Yes |
|
One green mana, one blue mana, or 2 life |
|
|
{G/W/P} | Yes |
|
One green mana, one white mana, or 2 life |
|
|
{R/G/P} | Yes |
|
One red mana, one green mana, or 2 life |
|
|
{R/W/P} | Yes |
|
One red mana, one white mana, or 2 life |
|
|
{U/B/P} | Yes |
|
One blue mana, one black mana, or 2 life |
|
|
{U/R/P} | Yes |
|
One blue mana, one red mana, or 2 life |
|
|
{W/B/P} | Yes |
|
One white mana, one black mana, or 2 life |
|
|
{W/U/P} | Yes |
|
One white mana, one blue mana, or 2 life |
|
|
{C/W} | Yes |
|
One colorless mana or one white mana |
|
|
{C/U} | Yes |
|
One colorless mana or one blue mana |
|
|
{C/B} | Yes |
|
One colorless mana or one black mana |
|
|
{C/R} | Yes |
|
One colorless mana or one red mana |
|
|
{C/G} | Yes |
|
One colorless mana or one green mana |
|
|
{2/W} | Yes |
|
Two generic mana or one white mana |
|
|
{2/U} | Yes |
|
Two generic mana or one blue mana |
|
|
{2/B} | Yes |
|
Two generic mana or one black mana |
|
|
{2/R} | Yes |
|
Two generic mana or one red mana |
|
|
{2/G} | Yes |
|
Two generic mana or one green mana |
|
|
{H} | Yes |
|
One colored mana or two life |
|
|
{W/P} | Yes |
|
One white mana or two life |
|
|
{U/P} | Yes |
|
One blue mana or two life |
|
|
{B/P} | Yes |
|
One black mana or two life |
|
|
{R/P} | Yes |
|
One red mana or two life |
|
|
{G/P} | Yes |
|
One green mana or two life |
|
|
{C/P} | Yes |
|
One colorless mana or two life |
|
|
{HW} | Yes |
|
One-half white mana |
|
|
{HR} | Yes |
|
One-half red mana |
|
|
{W} | Yes |
|
One white mana |
|
|
{U} | Yes |
|
One blue mana |
|
|
{B} | Yes |
|
One black mana |
|
|
{R} | Yes |
|
One red mana |
|
|
{G} | Yes |
|
One green mana |
|
|
{C} | Yes |
|
One colorless mana |
|
|
{S} | Yes |
|
One snow mana |
|
|
{L} | Yes |
|
One mana from a legendary source |
|
|
{D} | No |
One potential land drop |