> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flipsidecrypto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get up and running with FlipsideAI in minutes

## Ready to explore blockchain intelligence?

[Open FlipsideAI](https://flipsidecrypto.xyz/chat) and start your first conversation.

## Ways to start exploring

Not sure what to ask? Here are some proven entry points:

<CardGroup cols={2}>
  <Card title="Browse the prompt library" icon="book-open" href="https://science.flipsidecrypto.xyz/built-by-ai/">
    Explore real analyses built by the community. See what's possible, then adapt prompts to your needs.
  </Card>

  <Card title="Ask about a protocol" icon="chart-network">
    Try: "What do you know about \[protocol/token]?" Start broad, then dig into specifics based on what
    you learn.
  </Card>

  <Card title="Hover on the homepage" icon="mouse-pointer">
    Hover over blockchain icons or category tiles for curated prompt ideas tailored to that network or topic.
  </Card>
</CardGroup>

## Your first conversation

<Steps>
  <Step title="Start with a question">
    Ask about something specific you're curious about. **Always include chain and contract context when you know it:**

    * "Compare top NFT projects trading on Blur vs OpenSea over the last 30 days" ✅
    * "Show me whale activity for USDC on Arbitrum this week" ✅ (includes chain)
    * "What's the TVL trend for Uniswap v3 pools on Ethereum over the past quarter?" ✅ (includes chain)
    * "Show me USDC transfers" ❌ (missing chain - which chain?)

    The more context you provide upfront, the better the results.
  </Step>

  <Step title="Review the results">
    FlipsideAI will:

    * Plan the analysis
    * Write and execute SQL queries
    * Generate visualizations and insights

    Expand any **Flipside Data** box to see the exact query and raw data.
  </Step>

  <Step title="Iterate and refine">
    Keep the conversation going:

    * "Why is this number so high?"
    * "Show me this broken down by day"
    * "Add a comparison to Polygon"
    * "Can you visualize this as a line chart instead?"
  </Step>

  <Step title="Share your findings">
    When you're happy with the results:

    * Click **Publish Artifact** to share individual charts/reports
    * Use the purple **Share** button (top right) to make the entire conversation public
  </Step>
</Steps>

<Tip>
  The best insights come from iteration. Don't expect perfection on the first try—ask follow-ups,
  challenge the results, and dig deeper.
</Tip>

## Understanding what you see

When FlipsideAI responds, you'll see:

### Flipside Data boxes

These show query results with full transparency:

* Expand to see the exact SQL used
* Download results as CSV
* Verify filters, joins, and calculations

### Reports and artifacts

* **Report**: Formatted text analysis within the chat
* **Artifact**: Rich, shareable outputs with graphs, charts, and interactive elements

### Workflow indicators

If you see "Using workflow:" in the response, FlipsideAI is applying a specialized, pre-trained
methodology for structured analysis.

## Pro tips for getting started

<AccordionGroup>
  <Accordion title="Be specific with your questions" icon="bullseye">
    Instead of "Tell me about swaps on Blur," try:

    "Compare top NFT projects trading on Blur vs OpenSea over the last 30 days; include avg sale price and total volume; restrict to collections with >\$1M monthly volume."

    Specificity = better results.
  </Accordion>

  <Accordion title="Always provide chain and contract context" icon="network-wired">
    **This is critical:** If you know which chain(s) or contract(s) you want to analyze, tell FlipsideAI explicitly:

    * ✅ **Include chain names:** "Show me USDC transfers on Arbitrum" (not just "Show me USDC transfers")
    * ✅ **Use contract addresses when possible:** "Analyze 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 (USDC on Ethereum)"
    * ✅ **For multi-chain analysis:** "Compare USDC transfers on Ethereum, Arbitrum, and Polygon"
    * ❌ **Don't assume:** "Show me Uniswap activity" (which chain?)

    Many tokens exist on multiple chains, so being explicit eliminates ambiguity and ensures accurate results.

    [Learn more about providing context →](/flipsideai/prompting#provide-chain-and-contract-context)
  </Accordion>

  <Accordion title="Define your terms" icon="book">
    Tell FlipsideAI what you mean by:

    * **Thresholds**: whales `(>$100K)`, retail `(<$1K)`
    * **Time ranges**: use explicit dates, not "recently"
    * **User categories**: quality users `(score >4)`, new addresses `(first tx in period)`
  </Accordion>

  <Accordion title="Start broad, then narrow" icon="filter">
    Begin with an exploratory question, inspect the results, then refine:

    1. "Show me DEX activity on Base"
    2. Review results
    3. "Focus on the top 3 protocols by volume"
    4. Review again
    5. "Break down Uniswap swaps by token pair"
  </Accordion>

  <Accordion title="Use mentions to reference data" icon="at">
    Type `@` followed by your search terms to reference specific datasets or workflows:

    * `@ethereum defi` - Find Ethereum DeFi datasets
    * `@solana nft` - Find Solana NFT data
    * `@volume weighted analysis` - Access specialized workflows

    Mentions help FlipsideAI understand exactly which data sources you want to use.

    [Learn more about mentions →](/flipsideai/mentions)
  </Accordion>
</AccordionGroup>

## Common first questions

Try these to get a feel for FlipsideAI's capabilities:

<AccordionGroup>
  <Accordion title="Protocol activity" icon="chart-line">
    * "What's the daily active user trend for Aave on Ethereum over the past 90 days?"
    * "Compare lending volumes across Aave, Compound, and Maker on Ethereum this month"
  </Accordion>

  <Accordion title="Token analysis" icon="coins">
    * "Show me the top 20 holders of PEPE on Ethereum and how their holdings changed this year" -
      "What's the transfer activity for USDT on Ethereum, Arbitrum, and Polygon in the last week?"
  </Accordion>

  <Accordion title="User behavior" icon="users">
    * "Find addresses that bridged >\$10K from Ethereum to Arbitrum this month" - "Show me new wallets
      that started using Solana DeFi in Q1 2024"
  </Accordion>

  <Accordion title="Cross-chain comparisons" icon="globe">
    * "Compare DEX volumes across Ethereum, Arbitrum, and Optimism for the past 30 days"
    * "Which chains have the most NFT trading activity this week?"
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Master prompting" icon="wand-magic-sparkles" href="/flipsideai/prompting">
    Learn to craft questions that get the best results
  </Card>

  <Card title="Use mentions" icon="at" href="/flipsideai/mentions">
    Reference specific datasets and workflows with @
  </Card>

  <Card title="Customize with Rules" icon="sliders" href="/flipsideai/rules">
    Set up Rules to control response style and format
  </Card>

  <Card title="Understand analysis modes" icon="gears" href="/flipsideai/analysis-modes">
    Learn how FlipsideAI processes different types of questions
  </Card>

  <Card title="Work with data" icon="database" href="/flipsideai/data-and-results">
    Validate, download, and manipulate your results
  </Card>
</CardGroup>