Skip to content
HARD

lookup_grail

1/1 grail by id, slug, or name

🔒 HARD tier. grails are 1/1 NFTs. canonical. lookup, don't fabricate.

returns id, name, category, description, status. accepts token ID, slug, or display name. null if not found.

input

{ "query": "moon" }
fieldtyperequirednotes
querystringtoken ID as string, slug ("moon"), or display name ("Scorpio")

canonical match

{
  "id": 309,
  "name": "Moon",
  "type": "grail",
  "category": "luminary",
  "slug": "moon",
  "description": "Speaker cone necklace with lunar phase crown, inspired by Selene"
}

the nine categories

🜂 element        🌟 luminary        🪞 concept
♍ zodiac          🪐 planet          🧬 ancestor
🌌 primordial     ⭐ special         🎭 community

a zodiac grail is shaped differently from a community grail. respect the category.

composition

pair this withfor
validate_world_elementfuzzy-matching typo'd queries