Nadirball Football Grid

Use this when the user names a footballer for a square of today's Nadirball grid. Checks the player against Wikidata club histories and records the guess: a correct answer fills the square and gets its rarity, and a wrong one uses one of the day's 9 guesses. The answer is scored once this check has run, for typed and spoken answers alike. Takes the row and column numbers (1-3, from show_daily_grid) and the player's name as the user gave it; spelling without Turkish or other accents is fine, and a well-known surname alone works. A name that matches nobody, a first name or a surname many players share, a filled square or an already used player costs no guess: the result then has a refusal whose message, suitable to show the user, says why (for a shared name, it asks for the full name). Repeating the same guess changes nothing. The result's summary states the outcome and is suitable to show the user.

submit_answer

Use this when the user asks to delete their Nadirball data or history. Permanently deletes their boards, guesses, streak, share links and reports. Anonymous answer counts that rarity is computed from stay. This can't be undone.

delete_my_data

Use this when the user says they are done with today's grid or want to give up and see the answers. Ends the user's game for the day (the guesses left can't be used afterwards) and shows the final rarity score, the most picked and rarest answers for every square, and a share option.

finish_grid

From the grid card: the user believes a player marked wrong did play for both clubs. Saves the report for a person to check against the player's club history; an accepted report adds the missing club and turns the guess correct.

report_answer

Name search over every player Nadirball knows, for the grid card's answer box. Results hold names, birth years and nationality flags, with no club histories, so they don't show which players fit a square.

search_players

Use this when the user wants to share their Nadirball result. Creates (or returns the existing) public link to a page showing this grid's coloured squares, score and rarity, with no name or account details; players' names on it stay hidden until the grid closes at midnight Türkiye time. The result has the link (url), a ready-to-paste text version of the squares (text) and a summary suitable to show the user.

create_share_link

Use this when the user asks how they did on an earlier day's grid, or what the answers were. Shows that grid with the user's answers, the final rarity score and each square's most picked and rarest answers. Covers the last 30 days. Read-only.

show_grid_results

Use this when the user asks about their Nadirball streak, record or recent scores. Returns days played, current and best streak, perfect grids, best and average rarity score, and the last 7 grids. Read-only.

get_my_stats

Use this when the user wants to play Nadirball or see today's football grid. Shows the grid card: three row headers and three column headers (clubs from the Süper Lig, Premier League and Bundesliga, sometimes a nation), the user's answers so far, guesses left and the rarity score. The result contains no answers for open squares, so they stay hidden until the user finishes the grid; its summary is suitable to show the user. Read-only.

show_daily_grid