> ## 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.

# Chat

> Conversational interface for exploring and analyzing blockchain data

Chat is Flipspace's persistent, context-aware assistant. It's available on every page in the app and
knows what you're looking at — whether that's a query, an automation, a data table, or a report. Ask
it anything: write a query, build an automation, analyze data, or explore 20+ blockchains and
protocols.

## Chat Everywhere

Chat is always available and adapts to your context. Open it from any page and it understands what
you're working on — the query you're editing, the automation you're viewing, or the data you're
exploring. Conversations persist across sessions so you never lose your place.

<CardGroup cols={2}>
  <Card title="Write & Edit Queries" icon="code">
    Ask chat to write SQL, modify your current query, explain results, or debug errors — all with
    full context of what's in your editor
  </Card>

  <Card title="Build Automations" icon="diagram-project">
    Describe what you want to automate and chat will help you build and configure workflows
  </Card>

  <Card title="Analyze Data" icon="chart-mixed">
    Ask questions about any blockchain data and get answers backed by live queries across the full
    data catalog
  </Card>

  <Card title="Context-Aware Agents" icon="robot">
    Agents automatically adapt based on what you're looking at and the questions you ask, providing
    specialized expertise when you need it
  </Card>
</CardGroup>

## Opening Chat

Press **Cmd+B** from any view to open or close chat. You can also click the chat button in the
top-right corner.

Chat automatically picks up context from whatever you're viewing — your current query, automation,
data table, or report — so you can ask questions or give instructions without switching windows.

<Frame>
  <img src="https://mintcdn.com/flipside-3887e776/BGMDBFlS86qBuCYT/images/flipspace/persistent-chat.gif?s=205cb21e2f9c555ba8dc8200001936a4" alt="Persistent chat assistant in the query editor" width="1500" height="1030" data-path="images/flipspace/persistent-chat.gif" />
</Frame>

## Chat History

Click the clock icon at the top of the chat window to browse your previous conversations. You can
quickly pick up where you left off or revisit earlier analyses.

<Frame>
  <img src="https://mintcdn.com/flipside-3887e776/BGMDBFlS86qBuCYT/images/flipspace/chat-history-drawer.gif?s=43268616b41fa5477b4a2aa72ae04839" alt="Accessing chat history from the chat window" width="588" height="422" data-path="images/flipspace/chat-history-drawer.gif" />
</Frame>

## How It Works

<Steps>
  <Step title="Ask a question">
    Ask about any blockchain, protocol, token, or address. Include chain and contract context when
    you know it.
  </Step>

  <Step title="Chat analyzes">
    Chat formulates a plan, writes SQL queries, runs analyses, and generates outputs (text, charts,
    tables).
  </Step>

  <Step title="Iterate and refine">
    Keep the conversation going. Ask follow-ups, request different visualizations, or dig deeper
    into results.
  </Step>
</Steps>

## What You Can Do

### Data & Queries

* **Write SQL queries** — generate, edit, and run queries against Flipside's blockchain data
* **Explore tables** — discover and inspect available data tables and schemas
* **Analyze data** — run queries and get analysis and summaries of results

```text theme={null}
"What's the daily DEX volume on Arbitrum over the past 30 days?"
"Show me the schema for the Hyperliquid trades table"
"Find the top 5 wallets by realized PnL on Hyperliquid"
```

### Reports & Visualizations

* **Build reports** — create visual dashboards and reports from query results
* **Build charts** — generate charts and visualizations from data

```text theme={null}
"Create a line chart showing Aave TVL over the past quarter"
"Build a comparison dashboard for DEX volumes across L2s"
```

### Automations & Workflows

* **Build automations** — create scheduled workflows with natural language
* **Debug automations** — troubleshoot and analyze automation runs
* **Set up notifications** — configure Slack, Discord, and email alerts

```text theme={null}
"Create an automation that checks ETH whale movements daily"
"Why did my last automation run fail?"
"Set up a Slack alert when DEX volume spikes above $1B"
```

### Intelligence & Analytics

Chat includes specialized intelligence capabilities powered by [Agents](/flipspace/agents):

* **Stablecoin intelligence** — supply, flows, holders, and liquidity across EVM chains
* **Solana address intelligence** — user quality analysis, pockets of value, competitive comparisons
* **On-chain user intelligence** — cross-chain user scoring, sybil/cluster detection, wallet
  holdings, user journeys
* **Whale monitoring** — track top liquid addresses, ownership patterns, and flow-price correlations
* **Protocol revenue analysis** — fees and revenue breakdowns for DeFi protocols
* **Market maker tracking** — analyze liquidity provider movements on target chains and protocols
* **DeFi competitive landscape** — cross-chain competitive intel reports

### Agents & Skills

* **Create agents** — build new AI agents with custom configurations
* **Create skills** — build reusable skills for agents
* **Manage agents and skills** — update configs and inspect existing agents

[Learn more about Agents](/flipspace/agents)

## Understanding Results

### Flipside Data Boxes

Every query result appears in an expandable container showing:

* **Query preview**: What was analyzed
* **Results table**: Data returned
* **Full SQL**: Complete query for verification
* **Download**: Export as CSV

Always expand data boxes to verify the query matches your intent.

## Select an Agent

Choose which agent you want to chat with for specialized expertise. Each agent has different skills
and domain knowledge.

<Frame>
  <img src="https://mintcdn.com/flipside-3887e776/2p0PEJQiT2mOBFkO/images/flipspace/flipspace-chat-select-agent.png?fit=max&auto=format&n=2p0PEJQiT2mOBFkO&q=85&s=5e3f94a3f806fc5345c31b79c12d5ca9" alt="Select an agent to chat with" width="820" height="444" data-path="images/flipspace/flipspace-chat-select-agent.png" />
</Frame>

[Explore available agents](/flipspace/agents)

## Sharing chats

Share chat sessions with colleagues to provide context or collaborate on complex queries.

<Steps>
  <Step title="Open a chat">Navigate to the chat you want to share.</Step>

  <Step title="Generate a share link">
    Click the share icon within the chat to generate a unique URL.
  </Step>

  <Step title="Send the link">Share the URL directly with teammates in your organization.</Step>
</Steps>

<Note>
  Shared chats are view-only. Recipients can see the full conversation history including tool calls
  and data outputs, but cannot continue or fork the conversation.
</Note>

## Pro Tips

<AccordionGroup>
  <Accordion title="Be specific" icon="bullseye">
    Vague questions get vague answers. Include:

    * Chain names
    * Time periods
    * Contract addresses when known
    * Specific metrics you want
  </Accordion>

  <Accordion title="Iterate" icon="rotate">
    The best insights come from follow-up questions: - "Why is this number so high?" - "Break this
    down by day" - "Show me the top 10 instead of top 5"
  </Accordion>

  <Accordion title="Validate results" icon="check-double">
    Always verify important findings:

    * Expand data boxes to check SQL
    * Cross-reference with external sources
    * Ask Chat to explain its methodology
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Reports" icon="file-lines" href="/flipspace/reports">
    Create shareable intelligence reports
  </Card>

  <Card title="Agents" icon="robot" href="/flipspace/agents">
    Use specialized AI assistants
  </Card>

  <Card title="Automations" icon="diagram-project" href="/flipspace/automations">
    Apply structured methodologies
  </Card>

  <Card title="Queries" icon="code" href="/flipspace/sql-editor">
    Write, run, and manage SQL queries
  </Card>
</CardGroup>