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 Vectors
Whenever the API presents set of Magic colors, the column will be a vector 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 vector NULL
.
Common places were you might see this kind of vector are scry_cards()
’s colors
and color_identity
. When a color column is NULL
or NA
, it implies that that information is not pertinent for the current object. It does not imply that the object is colorless.
Color vectors are not guaranteed to be in a particular order.
A list of color representations is provided below:
Abbr. | Color | Basic Land | Mana Symbol |
---|---|---|---|
W |
White | Plains | |
U |
Blue | Island | |
B |
Black | Swamp | |
R |
Red | Mountain | |
G |
Green | Forest |
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, “, ” is written as {2/W}, {T}
.
An exhaustive list of all symbology is provided below. You can also retrieve this information programmatically using the scry_symbols()
function.
Note that some symbols use UTF-8 characters outside the ASCII range.
Symbol | Printed | Description |
---|---|---|
{T} |
Tap this permanent | |
{Q} |
Untap this permanent | |
{E} |
An energy counter | |
{PW} |
Planeswalker | |
{CHAOS} |
Chaos | |
{A} |
An acorn counter | |
{X} |
X generic mana | |
{Y} |
Y generic mana | |
{Z} |
Z generic mana | |
{0} |
Zero mana | |
{½} |
One-half generic mana | |
{1} |
One generic mana | |
{2} |
Two generic mana | |
{3} |
Three generic mana | |
{4} |
Four generic mana | |
{5} |
Five generic mana | |
{6} |
Six generic mana | |
{7} |
Seven generic mana | |
{8} |
Eight generic mana | |
{9} |
Nine generic mana | |
{10} |
Ten generic mana | |
{11} |
Eleven generic mana | |
{12} |
Twelve generic mana | |
{13} |
Thirteen generic mana | |
{14} |
Fourteen generic mana | |
{15} |
Fifteen generic mana | |
{16} |
Sixteen generic mana | |
{17} |
Seventeen generic mana | |
{18} |
Eighteen generic mana | |
{19} |
Nineteen generic mana | |
{20} |
Twenty generic mana | |
{100} |
One hundred generic mana | |
{1000000} |
One million generic mana | |
{∞} |
Infinite generic mana | |
{W/U} |
One white or blue mana | |
{W/B} |
One white or black mana | |
{B/R} |
One black or red mana | |
{B/G} |
One black or green mana | |
{U/B} |
One blue or black mana | |
{U/R} |
One blue or red mana | |
{R/G} |
One red or green mana | |
{R/W} |
One red or white mana | |
{G/W} |
One green or white mana | |
{G/U} |
One green or blue mana | |
{2/W} |
Two generic mana or one white mana | |
{2/U} |
Two generic mana or one blue mana | |
{2/B} |
Two generic mana or one black mana | |
{2/R} |
Two generic mana or one red mana | |
{2/G} |
Two generic mana or one green mana | |
{P} |
One colored mana or two life | |
{W/P} |
One white mana or two life | |
{U/P} |
One blue mana or two life | |
{B/P} |
One black mana or two life | |
{R/P} |
One red mana or two life | |
{G/P} |
One green mana or two life | |
{HW} |
One-half white mana | |
{HR} |
One-half red mana | |
{W} |
One white mana | |
{U} |
One blue mana | |
{B} |
One black mana | |
{R} |
One red mana | |
{G} |
One green mana | |
{C} |
One colorless mana | |
{S} |
One snow mana |