Skip to contents

An illustrated symbol 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 vignette("colors").

Usage

scry_symbols()

Value

A data frame with 1 row and the following columns:

  • symbol [chr]: The plaintext symbol. Often surrounded with curly braces. Note that not all symbols are ASCII text (for example, the infinity symbol).

  • colors [list]: A vector of colors that this symbol represents.

  • cmc [dbl]: A decimal number representing this symbol’s converted mana cost. Note that mana symbols from funny sets can have fractional converted mana costs.

  • loose_variant [chr]: An alternate version of this symbol, if it is possible to write it without curly braces.

  • english [chr]: An English snippet that describes this symbol. Appropriate for use in alt text or other accessible communication formats.

  • gatherer_alternates [list]: A vector 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.

  • transposable [lgl]: Whether 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.

  • represents_mana [lgl]: Whether this is a mana symbol.

  • appears_in_mana_costs [lgl]: Whether this symbol appears in a mana cost on any Magic card. For example {20} has this column set to FALSE because {20} only appears in Oracle text, not mana costs.

  • funny [lgl]: Whether this symbol is only used on funny cards or Un-cards.

  • svg_uri [chr]: A URI to an SVG image of this symbol on Scryfall’s CDNs.

Examples

# \donttest{
# Get information about symbols
scry_symbols()
#> # A tibble: 34 × 11
#>    symbol colors   cmc loose_variant english           gatherer_alterna…
#>    <chr>  <list> <dbl> <chr>         <chr>             <list>           
#>  1 {X}    <NULL>   0   X             X generic mana    <chr [2]>        
#>  2 {Y}    <NULL>   0   Y             Y generic mana    <NULL>           
#>  3 {Z}    <NULL>   0   Z             Z generic mana    <NULL>           
#>  4 {0}    <NULL>   0   0             zero mana         <chr [1]>        
#>  5 {½}    <NULL>   0.5 ½             one-half generic… <chr [1]>        
#>  6 {1}    <NULL>   1   1             one generic mana  <chr [1]>        
#>  7 {2}    <NULL>   2   2             two generic mana  <chr [1]>        
#>  8 {3}    <NULL>   3   3             three generic ma… <chr [1]>        
#>  9 {4}    <NULL>   4   4             four generic mana <chr [1]>        
#> 10 {5}    <NULL>   5   5             five generic mana <chr [1]>        
#> # … with 24 more rows, and 5 more variables: transposable <lgl>,
#> #   represents_mana <lgl>, appears_in_mana_costs <lgl>, funny <lgl>,
#> #   svg_uri <chr>
# }