> For the complete documentation index, see [llms.txt](https://docs.flash.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flash.im/readme.md).

# Overview

Every article that moves a market is read, analyzed, and structured before it reaches you. Importance, market sentiment, event type, and the entities involved arrive already attached, in 16 languages. One API call renders it inside the screen where trading happens.

<a href="https://assemble-1.gitbook.io/flash-ai/docs/" class="button primary" data-icon="book">Read the API docs</a> <a href="https://assemble-1.gitbook.io/flash-ai/whitepaper/" class="button secondary" data-icon="file-lines">White Paper</a> <a href="https://flash.im/terminal" class="button secondary" data-icon="terminal">Open Terminal</a> <a href="https://flash.im/newsroom" class="button secondary" data-icon="newspaper">Open Newsroom</a>

<figure><img src="/files/ru9iIZPL7W4YFH7bKnqv" alt="FLASH product overview"><figcaption></figcaption></figure>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><h2>51</h2></td><td><strong>Trusted sources</strong></td><td>7 primary institutional sources and 44 major outlets, read in real time.</td></tr><tr><td><h2>16</h2></td><td><strong>Languages</strong></td><td>Every story published simultaneously, license-free in all of them.</td></tr><tr><td><h2>18</h2></td><td><strong>Event types</strong></td><td>One fixed classification behind every judgment.</td></tr><tr><td><h2>10,000+</h2></td><td><strong>Covers</strong></td><td>Publication-grade cover images across 3,000 entities.</td></tr></tbody></table>

<h2 align="center">What makes this different</h2>

<p align="center">Until now, putting news on a platform meant running a newsroom you never signed up for. FLASH replaces that entire pipeline.</p>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><h4><i class="fa-bolt" style="color:$primary;">:bolt:</i></h4></td><td><h4>One request, the right news</h4></td><td>Send what the page is about; the news that belongs there comes back. No collection, no classification, no matching on your side.</td></tr><tr><td><h4><i class="fa-brain" style="color:$primary;">:brain:</i></h4></td><td><h4>Analysis arrives done</h4></td><td>Every item carries <code>impact</code>, <code>sentiment</code>, <code>eventType</code>, <code>impactScore</code>, and <code>entities</code>. Nothing to infer.</td></tr><tr><td><h4><i class="fa-scale-balanced" style="color:$primary;">:scale-balanced:</i></h4></td><td><h4>License-free</h4></td><td>Every story is an original work synthesized from what outlets and institutions publish, with the source credited in every item. Publish it on your platform freely.</td></tr><tr><td><h4><i class="fa-language" style="color:$primary;">:language:</i></h4></td><td><h4>16 languages, one integration</h4></td><td>The same item ships in English plus 15 translations. Every translation is a rendition of FLASH's own text, so the license-free position carries into all 16.</td></tr></tbody></table>

{% columns %}
{% column width="50%" %}

## Your first call, in minutes

Sign in once with Google and the key is issued immediately. No approval step, no sales call.

The same request shape works against every endpoint in the docs: swap the path, keep the header. Poll with a cursor and only what is new comes back.

<a href="https://flash.im/terminal" class="button primary" data-icon="key">Get an API key</a> <a href="https://assemble-1.gitbook.io/flash-ai/docs/quick-start" class="button secondary" data-icon="rocket-launch">Quick Start</a>
{% endcolumn %}

{% column width="50%" %}
{% stepper %}
{% step %}

#### Get your key

Open Terminal, click **Get API**, sign in with Google.
{% endstep %}

{% step %}

#### Make your first request

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```bash
curl -H "X-API-Key: sk_live_..." \
  "https://api.flash.im/v1/news?category=crypto&lang=en&limit=5"
```

{% endcode %}
{% endtab %}

{% tab title="JavaScript" %}
{% code overflow="wrap" %}

```javascript
const res = await fetch(
  "https://api.flash.im/v1/news?category=crypto&lang=en&limit=5",
  { headers: { "X-API-Key": "sk_live_..." } }
);

const { items } = await res.json();
```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import requests

res = requests.get(
    "https://api.flash.im/v1/news",
    headers={"X-API-Key": "sk_live_..."},
    params={"category": "crypto", "lang": "en", "limit": 5},
)

items = res.json()["items"]
```

{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### Read the judgment

The analysis is already on the item.

{% code title="response.json" overflow="wrap" %}

```json
{
  "items": [
    {
      "id": "n_8f3k2p",
      "headline": "Spot bitcoin ETFs snap ten-day slide with $221M inflow",
      "impact": 4,
      "sentiment": "Mildly Bullish",
      "eventType": "market-move",
      "impactScore": 76,
      "entities": [
        { "name": "Bitcoin", "aliases": ["BTC"], "ticker": "BTC" }
      ],
      "source": { "name": "Reuters" },
      "relatedCount": 13,
      "lang": "en"
    }
  ],
  "hasMore": true,
  "nextCursor": "c_9d2f1a"
}
```

{% endcode %}
{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="50%" %}

<figure><img src="https://468382786-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7nVdlTaqXsFc0dRaiSkz%2Fuploads%2FAdteZA7CxnBm3NAYMn6y%2Fone-card-judged.png?alt=media" alt="One card, already judged"><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" valign="middle" %}

## Every event arrives as one card, already judged

Content, intelligence, and source join in a single item. The same event reported by twenty outlets converges into one card, with the coverage count attached as evidence rather than twenty duplicates in your feed.

<a href="https://assemble-1.gitbook.io/flash-ai/docs/api-reference/news-item-fields" class="button primary" data-icon="table-list">News Item Fields</a>
{% endcolumn %}
{% endcolumns %}

<h2 align="center">Running where markets move</h2>

<p align="center">Tier-1 platforms already render the layer on their own screens.</p>

<figure><img src="/files/qmiMoYvng97csH0TDV0T" alt="Integrated with"><figcaption></figcaption></figure>

<figure><img src="https://468382786-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7nVdlTaqXsFc0dRaiSkz%2Fuploads%2Fn7ZkBmS1zUIeHJrOyNWV%2Fbacked-by.png?alt=media" alt="Backed by"><figcaption></figcaption></figure>

<h2 align="center">Who it's for</h2>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><h4><i class="fa-arrow-right-arrow-left" style="color:$primary;">:arrow-right-arrow-left:</i></h4></td><td><h4>Exchanges</h4></td><td>A news tab on the full stream, "why this price moved" context beside the chart, and the hourly Top 10 on the home screen.</td></tr><tr><td><h4><i class="fa-chart-pie" style="color:$primary;">:chart-pie:</i></h4></td><td><h4>Prediction markets</h4></td><td>Pass the contract question as-is; the news that grounds the bet renders beside it, and freezes into the contract's record at close.</td></tr><tr><td><h4><i class="fa-database" style="color:$primary;">:database:</i></h4></td><td><h4>Data providers</h4></td><td>Every asset detail page carries its own news section, joined on entities so a ticker and a full name resolve to the same subject.</td></tr><tr><td><h4><i class="fa-robot" style="color:$primary;">:robot:</i></h4></td><td><h4>AI agents</h4></td><td>A question is a sample; a market is a stream. Agents call the same endpoints and get the same judgment everyone else sees.</td></tr></tbody></table>

<h2 align="center">Start where it suits you</h2>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><h4><i class="fa-rocket-launch" style="color:$primary;">:rocket-launch:</i></h4></td><td><h4>Start building</h4></td><td>Get a key with one sign-in and make your first call in minutes.</td><td><a href="https://assemble-1.gitbook.io/flash-ai/docs/quick-start" class="button secondary">Quick Start</a></td></tr><tr><td><h4><i class="fa-file-lines" style="color:$primary;">:file-lines:</i></h4></td><td><h4>Understand the layer</h4></td><td>The full thesis: the problem, how it is built, what it covers, and where it is going.</td><td><a href="https://assemble-1.gitbook.io/flash-ai/whitepaper/" class="button secondary">White Paper</a></td></tr></tbody></table>