Agent skill

Flyai X402

by alextitonis in alextitonis/fly.ai

Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for…

MITAuto-check passedBusiness, Finance & HR

Install Flyai X402

skills CLI
$ npx skills add alextitonis/fly.ai --skill flyai-x402 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alextitonis/fly.ai flyai-x402 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alextitonis/fly.ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/flyai-x402 .claude/skills/flyai-x402 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flyai-x402
GitHub stars
141
Token cost
~1.6k tokens
SKILL.md length
812 words
Files
2 (incl. scripts)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for…

  • Works in 4 steps: Pick the command from the table for what… → Show the cost. Run the command without… → After a clear yes, run the same command… → …
  • The user pastes a polymarket.com link and asks what to pick
  • SKILL.md covers Rules, Steps and Options
  • Runs Python scripts from its folder; calls python and pip; reaches polymarket.com and flyai-x402.fly.dev; needs FLYAI_X402_KEY

What it does

Flyai X402 is an agent skill from alextitonis/fly.ai. Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for a token or the user's own series, the real cost of a trade on Robinhood Chain, a token check, a run of the real fly connectome, or a generated fly meme. Use when the user pastes a polymarket.com link and asks what to pick, asks "what does it cost to trade X on Robinhood Chain", "is this token safe", "forecast this"…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/flyai_x402.py`).

It sits in Business, Finance & HR. It works with x402, Polymarket, React and Circle USDC. The licence is MIT.

When your agent uses it

  • The user pastes a polymarket.com link and asks what to pick
  • Asks what does it cost to trade X on Robinhood Chain
  • Is this token safe
  • How would a real fly react

Example prompts

  • “what does it cost to trade X on Robinhood Chain”
  • “is this token safe”
  • “forecast this”
  • “/flyai-x402”

Requirements

  • Python 3
  • A credential in FLYAI_X402_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Pick the command from the table for what the user asked. If they ask what is on offer, run products.
  2. Show the cost. Run the command without --yes; it prints needs_payment with the cost and the network.
  3. After a clear yes, run the same command with --yes.
  4. Read the answer back in plain words, then the record when there is one.

What it can do on your machine

Read from SKILL.md and the folder at commit bb0fdcb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • polymarket.com
    • flyai-x402.fly.dev

    Also links to:

    • flyaiworld.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FLYAI_X402_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flyai X402 loads about 1.6k tokens when it runs. Until then it costs about 157 tokens; SKILL.md has 812 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~157
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alextitonis/fly.ai at commit bb0fdcb, republished under its MIT licence (© alextitonis). 812 words, ~1,577 tokens.

Download SKILL.mdSave it as .claude/skills/flyai-x402/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
flyai-x402
description
Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for a token or the user's own series, the real cost of a trade on Robinhood Chain, a token check, a run of the real fly connectome, or a generated fly meme. Use when the user pastes a polymarket.com link and asks what to pick, asks "what does it cost to trade X on Robinhood Chain", "is this token safe", "forecast this", "how would a real fly react", "make me a fly meme", says "/flyai-x402", or wants any of those records.

fly.ai pay-per-request 🪰

fly.ai sells single answers, each paid on its own. Everything goes through scripts/flyai_x402.py, which sits next to this file (pip install requests eth-account). Its notes for the person go to stderr and one JSON document for you goes to stdout.

CommandPriceWhat comes back
market <link, id or slug>$0.05The desk model's probability for a Polymarket market, the market's price, the side it leans to, its record
picks [--limit 10]$0.05Open markets where the model and the price disagree most
forecast <symbol or address> [--horizon 8]$0.03TimesFM forecast with a band for a token the desk tracks (15-minute bars)
forecast-series <file.json> [--step 3600] [--horizon 8]$0.03The same for the user's own list of numbers
cost <symbol or address> [--usd 100]$0.02Real round-trip cost on Robinhood Chain at that size, through the best pool
token <address>$0.03Pools, age, links, copycats, contract and holder facts for a Robinhood Chain token
brain --sense <sense> or brain "<message>"$0.05A run of the real fly connectome: what the fly did
meme "<idea>" [--style] [--top] [--bottom] [--out]$0.20A generated fly meme, saved as a .webp file
products, record, forecast-record, senses, stylesfreeThe catalogue, the two records, the senses and meme styles

Rules

  • Money moves only with the user's OK. A paid command without --yes pays nothing: it prints the cost. Show the user that cost and wait for a clear yes before running it again with --yes. One yes covers one request unless the user says otherwise.
  • Never ask for, read, print or type a private key. Paying needs a wallet key in the environment variable FLYAI_X402_KEY, which the user sets themselves, outside the chat. If it is missing, tell them to set it (a fresh wallet holding a dollar or two is plenty) and stop. Do not suggest pasting the key into the conversation and do not echo the variable.
  • Always pass on the record. A Polymarket or forecast answer has a record block. Say in plain words how the model has done (for example "on 50 resolved markets it has been worse than the market's own price", or "the forecasts rank which tokens will move most, but their direction has shown no edge"). Never present a lean or a forecast as a tip that will win, and never size a bet or a trade for the user. These are a model's opinions, not advice.
  • Facts stay facts. cost and token are measurements and lookups, not opinions. Report the numbers and the flags; do not call a token "safe". An empty flags list is not a clean bill of health.
  • A failed request costs nothing. An unknown market or token (404), an event with several markets (409), a bad input (400) or an outage (503) is answered before any payment is taken. Say so rather than retrying blindly.
Show full SKILL.md (337 more words)Show less

Steps

  1. Pick the command from the table for what the user asked. If they ask what is on offer, run products.
  2. Show the cost. Run the command without --yes; it prints needs_payment with the cost and the network.
  3. After a clear yes, run the same command with --yes.
  4. Read the answer back in plain words, then the record when there is one.
bash
python scripts/flyai_x402.py market "https://polymarket.com/event/<event>/<market>"         # the cost
python scripts/flyai_x402.py market "https://polymarket.com/event/<event>/<market>" --yes   # after a yes
python scripts/flyai_x402.py cost NVDA --usd 200 --yes
python scripts/flyai_x402.py token 0x0088CE7905025c4B5ea1d49aB6179B6aaADB3B9C --yes
python scripts/flyai_x402.py forecast NVDA --horizon 8 --yes
python scripts/flyai_x402.py brain "someone brought pizza" --yes
python scripts/flyai_x402.py meme "monday meetings" --top "WHEN THE STANDUP" --bottom "RUNS LONG" --yes

Notes on each:

  • market: a polymarket.com link is best. A link to an event that holds several markets comes back as a list (markets, free): show the questions, let the user choose, and ask again with that market's id.
  • forecast: symbols are the desk's tickers (NVDA, FLYAI, base:ETH) or a Robinhood Chain token address. The answer is a path of values with a lower and upper band. For the user's own data use forecast-series with a JSON file holding a list of at least 24 numbers, oldest first, and --step for the seconds between them.
  • cost: round_trip_cost_pct is buying then selling at once, fees, price impact and token tax included, gas not. best is the cheapest of the pools tried.
  • token: flags lists what stands out (honeypot or tax reports, a thin pool, copycat tickers, a dead website, a young pool, concentrated holders).
  • brain: senses are threat, taste, mate, wind, touch, smell, nothing. With a message, a keyword table picks the sense; say which sense was used. did is what the fly's neurons made it do.
  • meme: ideas follow all-ages rules and are refused, free, if not allowed. The image is saved to --out (default fly-meme.webp); tell the user where it is.

Options

  • --network base pays in USDC on Base instead of USDG on Robinhood Chain (the default).
  • --max-price 0.5 refuses to pay more than this for one request. Leave it unless the user asks.
  • FLYAI_X402_URL points the script at another address (default https://flyai-x402.fly.dev).

Any x402 client can use the service without this script: a request without payment returns HTTP 402 with the standard accepts list. The full guide is https://www.flyaiworld.com/x402-api.md.

© alextitonis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/flyai-x402 of alextitonis/fly.ai.

  • SKILL.md
  • scripts/flyai_x402.py

Open the folder on GitHubat commit bb0fdcb

Compare with similar skills

Flyai X402 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flyai X402 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flyai X402 this skillalextitonis/fly.ai141—~1.6kAutomated safety check: PassMIT
Polymarket TradingBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT
Predexon Prediction Market DataBlockRunAI/ClawRouter6.6k—~4.7kAutomated safety check: PassMIT
Surf Crypto Data APIBlockRunAI/blockrun-mcp391—~1.7kAutomated safety check: PassMIT
BlockrunBlockRunAI/blockrun-mcp391—~2.7kAutomated safety check: PassMIT
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT

Similar skills

  • Polymarket Trading

    BlockRunAI/ClawRouter

    A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

    6.6k GitHub stars~1.4k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Predexon Prediction Market Data

    BlockRunAI/ClawRouter

    Reads structured prediction market data for Polymarket, Kalshi and other venues through a local BlockRun gateway: markets, search, leaderboards, wallet analytics and odds.

    6.6k GitHub stars~4.7k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Surf Crypto Data API

    BlockRunAI/blockrun-mcp

    Routes crypto market, on-chain, wallet and prediction-market lookups to the Surf data API through a local ClawRouter, paid per call.

    391 GitHub stars~1.7k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    391 GitHub stars~2.7k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Surf

    BlockRunAI/ClawRouter

    Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

    6.6k GitHub stars~4k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Pay people in SOL or USDC, buy and sell tokens, check prices, discover trending and new tokens, create and manage Solana wallets, stake SOL, earn yield through lending and managed vaults, borrow…

    156 GitHub starsUsed in 1 repo~4.7k tokens
    Business, Finance & HRAuto-check passed

More from alextitonis/fly.ai

  • Fly Mode

    alextitonis/fly.ai

    Turn Claude into a fruit fly whose reactions come from a real fly brain (the 166,700-neuron MaleCNS connectome, via the flybrain pip package).

    141 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Flyai Compute

    alextitonis/fly.ai

    Run jobs on the fly.ai compute network and pay for them - fly connectome experiments, or the user's own WebAssembly programs and WGSL GPU shaders, run by browser miners.

    141 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Questions about Flyai X402

What does Flyai X402 do?

Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for…. ai.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for a token or the user's own series, the real cost of a trade on Robinhood Chain, a token check, a run of the real fly connectome, or a generated fly meme.

When should I use Flyai X402?

Flyai X402 fits situations like: the user pastes a polymarket.com link and asks what to pick; asks what does it cost to trade X on Robinhood Chain; is this token safe; how would a real fly react.

How do I install Flyai X402 in Claude Code?

Run `npx skills add alextitonis/fly.ai --skill flyai-x402 -a claude-code`. Or copy the skill folder (skills/flyai-x402 in alextitonis/fly.ai) into .claude/skills/flyai-x402 in your project. Claude Code loads it when a task matches its description.

How do I install Flyai X402 in Codex?

Run `npx skills add alextitonis/fly.ai --skill flyai-x402 -a codex`. Or copy the skill folder (skills/flyai-x402 in alextitonis/fly.ai) into .agents/skills/flyai-x402 in your project. Codex loads it when a task matches its description.

Can I use Flyai X402 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alextitonis/fly.ai --skill flyai-x402 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flyai-x402, .gemini/skills/flyai-x402, .github/skills/flyai-x402 and .opencode/skills/flyai-x402 in your project.

What does Flyai X402 need to run?

Going by SKILL.md and its folder, Flyai X402 needs Python for the scripts in its folder, the command-line tools its instructions call (python and pip) and credentials named FLYAI_X402_KEY. Our summary lists: Python 3; A credential in FLYAI_X402_KEY.

Does Flyai X402 access the network?

SKILL.md names 3 domains. In commands or code: polymarket.com and flyai-x402.fly.dev; the agent is likely to contact these when it follows the instructions. As links in the text: flyaiworld.com. This is read from the text; nothing was executed.

Is Flyai X402 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Flyai X402 use?

Flyai X402 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flyai X402 use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flyai X402?

Skills that share tags, products or a category with Flyai X402: Polymarket Trading (BlockRunAI/ClawRouter, 6.6k stars), Predexon Prediction Market Data (BlockRunAI/ClawRouter, 6.6k stars), Surf Crypto Data API (BlockRunAI/blockrun-mcp, 391 stars) and Blockrun (BlockRunAI/blockrun-mcp, 391 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flyai X402?

alextitonis (a GitHub user) maintains it in alextitonis/fly.ai, which has 141 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 10, 2026.

Source: alextitonis/fly.ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.