# Table of Contents

- [Welcome to Airaa 👨‍🌾 | AIRAA](#welcome-to-airaa-airaa)
- [Market Analytics | AIRAA](#market-analytics-airaa)
- [Market Intelligence | AIRAA](#market-intelligence-airaa)
- [What is Airaa? | AIRAA](#what-is-airaa-airaa)
- [Projects | AIRAA](#projects-airaa)
- [Aura Boards | AIRAA](#aura-boards-airaa)
- [Why Airaa exists? | AIRAA](#why-airaa-exists-airaa)
- [Airaa Pro | AIRAA](#airaa-pro-airaa)
- [API | AIRAA](#api-airaa)
- [Contributors | AIRAA](#contributors-airaa)
- [Discovery | AIRAA](#discovery-airaa)
- [Narratives | AIRAA](#narratives-airaa)
- [Status | AIRAA](#status-airaa)
- [Leaderboards | AIRAA](#leaderboards-airaa)
- [Feed & Events | AIRAA](#feed-events-airaa)
- [Aura Boards | AIRAA](#aura-boards-airaa)
- [What is Airaa? | AIRAA](#what-is-airaa-airaa)

---

# Welcome to Airaa 👨‍🌾 | AIRAA

![Page cover](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FMW1KHCDiepfpSwlWxjcI%252Fimage.png%3Falt%3Dmedia%26token%3D8ee961c3-e0bb-4730-9f30-ed777f15d2dc&width=1248&dpr=4&quality=100&sign=873fa583&sv=2)

Airaa is an intelligence layer for web3 that connects social and onchain data into one place.

It helps projects, investors, and contributors cut through noise, track narratives as they form, and understand who drives real impact.

Jump right in!

[](https://airaa.gitbook.io/docs/getting-started/quickstart)

![Cover](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252F2aXmD7VMsrRlZvOk5ytB%252Fimage%2520%2819%29.png%3Falt%3Dmedia%26token%3Dc4711e2a-e0ba-40a6-aced-3379cccb2619&width=245&dpr=4&quality=100&sign=a15adf1b&sv=2)

#### 

[](https://airaa.gitbook.io/docs#undefined)

**Getting Started**

Learn about Airaa

[](https://airaa.gitbook.io/docs/products/editor)

![Cover](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252F2BtTpx18pwGpzzXavXIW%252Fimage%2520%2820%29.png%3Falt%3Dmedia%26token%3Dd2948a77-ccd9-42d1-b11a-c17657e1fddc&width=245&dpr=4&quality=100&sign=c932bc5c&sv=2)

#### 

[](https://airaa.gitbook.io/docs#undefined-1)

**Products**

Explore our products

[](https://airaa.gitbook.io/docs/products/integrations)

![Cover](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252Fz4xT9QPl0fV2cZKvEzEz%252Fimage%2520%2821%29.png%3Falt%3Dmedia%26token%3Db6f69cf3-f085-4a02-87f1-01a5a3c16aa0&width=245&dpr=4&quality=100&sign=db7062da&sv=2)

#### 

[](https://airaa.gitbook.io/docs#undefined-2)

**API**

Access our APIs

[NextWhat is Airaa?](https://airaa.gitbook.io/docs/getting-started/quickstart)

Last updated 6 days ago

---

# Market Analytics | AIRAA

Market Analytics gives a complete view of a project by bringing social and on-chain signals together with context such as funding, team, announcements, and key interactions.

It allows users to track sentiment, activity, and community networks in one place, supported by leaderboards that show who is driving impact. For projects, funds, and contributors, it provides a structured way to understand how narratives form and how engagement translates into measurable outcomes.

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FnGqNmDHxIDMt0iVwLex8%252FScreenshot%25202025-08-28%2520at%25204.07.32%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3D948d1740-f159-4b95-97c7-971f4118767b&width=768&dpr=4&quality=100&sign=d15a7c93&sv=2)

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FqzbjaYC4OOp7Fg8IeC7J%252FScreenshot%25202025-08-28%2520at%25204.07.55%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3Dee6bc4f6-a8a8-421c-a72c-bbc09332d98e&width=768&dpr=4&quality=100&sign=517da921&sv=2)

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FYU1u3l9CwNdO6tk1gA2b%252FScreenshot%25202025-08-28%2520at%25204.08.23%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3D8899c9c5-1676-44f5-b464-73e53728c3a8&width=768&dpr=4&quality=100&sign=a9e3535e&sv=2)

[PreviousMarket Intelligence](https://airaa.gitbook.io/docs/products/markdown)
[NextAiraa Pro](https://airaa.gitbook.io/docs/products/interactive-blocks)

Last updated 6 days ago

---

# Market Intelligence | AIRAA

Market Intelligence tracks unique signals across both social platforms and onchain activity to help users understand what is happening in crypto and why. Instead of raw feeds of data, it highlights events that carry meaningful context.

Currently, this is divided into three views:

*   **Breakouts**: Identifies projects that have recently seen a sharp increase in attention. The system connects this rise to specific reasons drawn from community discussions.
    
*   **Sentiment Shifts**: Surfaces when sentiment around a project changes direction, together with the conversations that triggered the move.
    
*   **Alphas**: Highlights newer or smaller projects that are gaining traction among smart accounts and showing signs of consistent progress.
    

The purpose is to reduce noise and give users a structured way to follow narratives, sentiment, and adoption signals without needing to manually piece together information from multiple platforms.

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FrcJTakIk2NFWgMUGBgyr%252FScreenshot%25202025-08-28%2520at%252012.57.40%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3D11d7ffa8-62bf-4f30-a50a-bc4ddfd013d6&width=768&dpr=4&quality=100&sign=a11d8ffa&sv=2)

[PreviousAura Boards](https://airaa.gitbook.io/docs/products/editor)
[NextMarket Analytics](https://airaa.gitbook.io/docs/products/images-and-media)

Last updated 6 days ago

---

# What is Airaa? | AIRAA

Airaa is an intelligence layer for Web3.

It brings together data from social platforms and onchain activity to make communities, projects, and contributors measurable.

With Airaa you can:

*   Track how narratives form and spread across Twitter, Discord, and blockchains.
    
*   Discover which contributors actually add value in a project.
    
*   Run campaigns with reward pools that incentivise genuine engagement instead of spam.
    
*   Access analytics and APIs that help VCs, protocols, and researchers make better decisions.
    

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FETMYmgLH0fEor4LsJp7M%252FScreenshot%25202025-08-28%2520at%252012.58.43%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3Dc499ec00-3453-4d7a-a9e3-2d38b49cb55c&width=768&dpr=4&quality=100&sign=55bbc2d&sv=2)

[PreviousWelcome to Airaa 👨‍🌾](https://airaa.gitbook.io/docs)
[NextWhy Airaa exists?](https://airaa.gitbook.io/docs/getting-started/publish-your-docs)

Last updated 6 days ago

---

# Projects | AIRAA

Project-level intelligence endpoints

### 

[](https://airaa.gitbook.io/docs/products/integrations/projects#get-projects-insights)

Project Insights

get

https://api.airaa.xyz/v1/projects/insights

Full intelligence profile for a project including sentiment, engagement, token data and contributor counts.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

project\_idstringRequired

Unique identifier for the project

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

Responses

200

Project insights returned

application/json

Responseobject

Show properties

get

/projects/insights

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/projects/insights HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Project insights returned

Copy

    {
      "project_id": "text",
      "name": "text",
      "category": "text",
      "sentiment": 1,
      "engagement": 1,
      "mentions": 1,
      "total_contributors": 1,
      "token_data": {
        "symbol": "text",
        "price_usd": 1,
        "volume_24h": 1,
        "market_cap": 1
      }
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/projects#get-projects-metadata)

Project Metadata

get

https://api.airaa.xyz/v1/projects/metadata

Retrieve metadata for a given project (ID, categories, tags).

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

project\_idstringRequired

Unique identifier for the project

Responses

200

Metadata returned

application/json

Responseobject

Show properties

get

/projects/metadata

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/projects/metadata HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Metadata returned

Copy

    {
      "project_id": "text",
      "name": "text",
      "category": "text",
      "tags": [\
        "text"\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/projects#get-projects-contributors)

Project Contributors

get

https://api.airaa.xyz/v1/projects/contributors

List top contributors to a project based on chosen interval/platform.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

project\_idstringRequired

Unique identifier for the project

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Project contributors returned

application/json

Responseobject

Show properties

get

/projects/contributors

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/projects/contributors HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Project contributors returned

Copy

    {
      "project_id": "text",
      "contributors": [\
        {\
          "contributor_id": "text",\
          "username": "text",\
          "mindshare_score": 1,\
          "rank": 1,\
          "raw_score": 1\
        }\
      ]
    }

[PreviousContributors](https://airaa.gitbook.io/docs/products/integrations/contributors)
[NextNarratives](https://airaa.gitbook.io/docs/products/integrations/narratives)

---

# Aura Boards | AIRAA

The Aura Boards are campaign specific leaderboard that ranks contributors based on their actions across socials and onchain. Each campaign has its own Aura Board, with scoring rules defined by the partner project running it.

The Aura Board serves two purposes:

*   **For contributors**: it shows how actions translate into measurable influence and where they stand compared to others.
    
*   **For projects**: it provides a transparent way to evaluate community engagement and distribute rewards fairly.
    

Interested in running your own campaign? Reachout to us [here](https://t.me/lightwaslost?text=hey%20light%2C%20would%20love%20to%20learn%20more%20about%airaa%campaigns)
.

#### 

[](https://airaa.gitbook.io/docs/products/editor#how-aura-is-calculated)

How Aura is Calculated

Aura is currently built from three data sources: **X, Discord, and onchain activity**. The final scoring weights and criteria are fully modular, allowing each project to decide which actions matter most. This creates a unified leaderboard that reflects contributions across platforms rather than isolating them.

#### 

[](https://airaa.gitbook.io/docs/products/editor#key-components-of-the-aura-board)

Key Components of the Aura Board

*   **Socials**: shows which platforms a contributor is active on
    
*   **Multiplier**: displays the boost earned from on-chain usage or other campaign-defined actions
    
*   **Aura %**: the contributor’s share of total campaign aura
    
*   **Connections**: highlights the contributor’s links to other community members
    

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252F9xdLRTkVrjahI02426DD%252FScreenshot%25202025-08-28%2520at%25201.02.22%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3D9b0cd009-d182-4a9a-8b09-51728d5028df&width=768&dpr=4&quality=100&sign=2a0b48b3&sv=2)

Aura board is in beta and will go through multiple algorithm iterations to filter bots and spam.

[PreviousWhy Airaa exists?](https://airaa.gitbook.io/docs/getting-started/publish-your-docs)
[NextMarket Intelligence](https://airaa.gitbook.io/docs/products/markdown)

Last updated 6 days ago

---

# Why Airaa exists? | AIRAA

Crypto communities are noisy and fragmented. Narratives move from Telegram chat, spread on X, get debated on Discord, and only later show up onchain. By then, most teams are already late.

Today, data is scattered across platforms. Analysts spend hours exporting CSVs, scraping messages, and switching between dashboards. Instead of answers, teams are left with dozens of non-curated data sources spread across random platforms. Each shows only a slice of the picture, which makes the problem worse instead of solving it.

Airaa exists to solve this problem. Airaa brings data from your favourite platforms in one place, making it possible to track narratives, research faster, and act on data backed signals.

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252F0MOfxgSd9Czoxgrrv7wv%252FScreenshot%25202025-08-28%2520at%252012.59.01%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3D90c10b5f-bae1-4bfc-8d62-8b8e26a5f7a1&width=768&dpr=4&quality=100&sign=f753ecec&sv=2)

[PreviousWhat is Airaa?](https://airaa.gitbook.io/docs/getting-started/quickstart)
[NextAura Boards](https://airaa.gitbook.io/docs/products/editor)

Last updated 4 days ago

---

# Airaa Pro | AIRAA

Coming soon.

Interested in accessing our data via APIs? Reachout to us [here](https://t.me/lightwaslost?text=hey%20light%2C%20would%20love%20to%20learn%20more%20about%your%20apis)
.

[PreviousMarket Analytics](https://airaa.gitbook.io/docs/products/images-and-media)
[NextAPI](https://airaa.gitbook.io/docs/products/integrations)

Last updated 6 days ago

---

# API | AIRAA

You can access Airaa’s intelligence directly through our APIs. They provide programmatic access to project data, leaderboards, and insights so you can integrate Airaa into your own tools and workflows.

Interested in accessing our data via APIs? Reachout to us [here](https://t.me/lightwaslost?text=hey%20light%2C%20would%20love%20to%20learn%20more%20about%your%20apis)
.

[PreviousAiraa Pro](https://airaa.gitbook.io/docs/products/interactive-blocks)
[NextContributors](https://airaa.gitbook.io/docs/products/integrations/contributors)

Last updated 6 days ago

---

# Contributors | AIRAA

Contributor intelligence endpoints

### 

[](https://airaa.gitbook.io/docs/products/integrations/contributors#get-contributors-profile)

Contributor Profile

get

https://api.airaa.xyz/v1/contributors/profile

Get full contributor profile including bio, activity and InfoFi scores.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

contributor\_idstringRequired

Unique identifier for the contributor (e.g., Twitter handle, Discord ID)

Responses

200

Contributor profile returned

application/json

Responseobject

Show properties

get

/contributors/profile

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/contributors/profile HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Contributor profile returned

Copy

    {
      "contributor_id": "text",
      "username": "text",
      "display_name": "text",
      "bio": "text",
      "platforms": [\
        "text"\
      ],
      "follower_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "influence_score": 1,
      "engagement_score": 1,
      "total_project_mentions": 1,
      "bullish_mentions": 1,
      "bearish_mentions": 1,
      "friends": [\
        "text"\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/contributors#get-contributors-engagement)

Contributor Engagement

get

https://api.airaa.xyz/v1/contributors/engagement

Retrieve engagement metrics for a contributor, including raw data.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

contributor\_idstringRequired

Unique identifier for the contributor

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

Responses

200

Contributor engagement returned

application/json

Responseobject

Show properties

get

/contributors/engagement

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/contributors/engagement HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Contributor engagement returned

Copy

    {
      "mentions": 1,
      "impressions": 1,
      "engagement_rate": 1,
      "reach": 1,
      "raw_data": [\
        {\
          "platform": "text",\
          "content": "text",\
          "timestamp": "2025-09-03T08:07:51.153Z",\
          "metrics": {\
            "likes": 1,\
            "comments": 1,\
            "shares": 1\
          }\
        }\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/contributors#get-contributors-history-mentions)

Mentions History

get

https://api.airaa.xyz/v1/contributors/history/mentions

Get historical mentions for a contributor.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

contributor\_idstringRequired

Unique identifier for the contributor

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

Responses

200

Mentions history returned

application/json

Responseobject

Show properties

get

/contributors/history/mentions

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/contributors/history/mentions HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Mentions history returned

Copy

    {
      "contributor_id": "text",
      "history": [\
        {\
          "date": "2025-09-03",\
          "mentions": 1\
        }\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/contributors#get-contributors-history-engagement)

Engagement History

get

https://api.airaa.xyz/v1/contributors/history/engagement

Track contributor engagement trends over time.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

contributor\_idstringRequired

Unique identifier for the contributor

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

Responses

200

Engagement history returned

application/json

Responseobject

Show properties

get

/contributors/history/engagement

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/contributors/history/engagement HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Engagement history returned

Copy

    {
      "contributor_id": "text",
      "history": [\
        {\
          "date": "2025-09-03",\
          "engagement_score": 1\
        }\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/contributors#get-contributors-top)

Top Contributors

get

https://api.airaa.xyz/v1/contributors/top

Get leaderboard of top contributors across filters (e.g. influence, consistency).

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

min\_engagementnumberOptional

Minimum engagement score to filter results

min\_influencenumberOptional

Minimum influence score to filter results

Responses

200

Top contributors returned

application/json

Responseobject

Show properties

get

/contributors/top

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/contributors/top HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Top contributors returned

Copy

    {
      "contributors": [\
        {\
          "contributor_id": "text",\
          "username": "text",\
          "rank": 1,\
          "score": 1\
        }\
      ]
    }

[PreviousAPI](https://airaa.gitbook.io/docs/products/integrations)
[NextProjects](https://airaa.gitbook.io/docs/products/integrations/projects)

---

# Discovery | AIRAA

APIs for discovering projects & contributors

### 

[](https://airaa.gitbook.io/docs/products/integrations/discovery#get-discovery-projects)

Discover Projects

get

https://api.airaa.xyz/v1/discovery/projects

Search or filter supported projects by ecosystem, category, etc.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

searchstringOptional

Search term to filter projects by name or description

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Projects discovered

application/json

Responseobject

Show properties

get

/discovery/projects

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/discovery/projects HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Projects discovered

Copy

    {
      "projects": [\
        {\
          "project_id": "text",\
          "name": "text",\
          "ecosystem": "text",\
          "category": "text"\
        }\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/discovery#get-discovery-contributors)

Discover Contributors

get

https://api.airaa.xyz/v1/discovery/contributors

Discover contributors by filters (ecosystem, category).

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

searchstringOptional

Search term to filter contributors by username or display name

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Contributors discovered

application/json

Responseobject

Show properties

get

/discovery/contributors

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/discovery/contributors HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Contributors discovered

Copy

    {
      "contributors": [\
        {\
          "contributor_id": "text",\
          "username": "text",\
          "ecosystem": "text",\
          "category": "text"\
        }\
      ]
    }

[PreviousLeaderboards](https://airaa.gitbook.io/docs/products/integrations/leaderboards)
[NextFeed & Events](https://airaa.gitbook.io/docs/products/integrations/feed-and-events)

---

# Narratives | AIRAA

Narrative discovery & trend endpoints

### 

[](https://airaa.gitbook.io/docs/products/integrations/narratives#get-narratives-trending)

Trending Narratives

get

https://api.airaa.xyz/v1/narratives/trending

Get list of trending narratives across social + onchain data.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Trending narratives returned

application/json

Responseobject\[\]

Show properties

get

/narratives/trending

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/narratives/trending HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Trending narratives returned

Copy

    [\
      {\
        "narrative_id": "text",\
        "title": "text",\
        "category": "text",\
        "description": "text",\
        "mentions_count": 1,\
        "engagement_score": 1,\
        "sentiment": 1,\
        "velocity": 1\
      }\
    ]

### 

[](https://airaa.gitbook.io/docs/products/integrations/narratives#get-narratives-history)

Narrative History

get

https://api.airaa.xyz/v1/narratives/history

Track historical mentions & momentum of a narrative.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

narrative\_idstringRequired

Unique identifier for the narrative

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

Responses

200

Narrative history returned

application/json

Responseobject

Show properties

get

/narratives/history

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/narratives/history HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Narrative history returned

Copy

    {
      "narrative_id": "text",
      "history": [\
        {\
          "date": "2025-09-03",\
          "mentions": 1,\
          "sentiment": 1\
        }\
      ]
    }

[PreviousProjects](https://airaa.gitbook.io/docs/products/integrations/projects)
[NextLeaderboards](https://airaa.gitbook.io/docs/products/integrations/leaderboards)

---

# Status | AIRAA

API and system health checks

### 

[](https://airaa.gitbook.io/docs/products/integrations/status#get-status-api-key)

API Key Status

get

https://api.airaa.xyz/v1/status/api-key

Check current API key usage, quota and limits.

Authorizations

ApiKeyAuth

ApiKeyAuth

Responses

200

API key status returned

application/json

Responseobject

Show properties

get

/status/api-key

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/status/api-key HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

API key status returned

Copy

    {
      "valid": true,
      "remaining_requests": 1,
      "reset_time": "2025-09-03T09:42:52.041Z"
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/status#get-status-server)

Server Status

get

https://api.airaa.xyz/v1/status/server

Check API server health.

Authorizations

ApiKeyAuth

ApiKeyAuth

Responses

200

Server status returned

application/json

Responseobject

Show properties

get

/status/server

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/status/server HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Server status returned

Copy

    {
      "status": "healthy",
      "uptime": 1,
      "response_time": 1
    }

[PreviousFeed & Events](https://airaa.gitbook.io/docs/products/integrations/feed-and-events)

---

# Leaderboards | AIRAA

Custom and system leaderboards

### 

[](https://airaa.gitbook.io/docs/products/integrations/leaderboards#post-leaderboards-create)

Create Leaderboard

post

https://api.airaa.xyz/v1/leaderboards/create

Create a custom leaderboard with keywords and weighted metrics.

Authorizations

ApiKeyAuth

ApiKeyAuth

Body

application/json

application/json

namestringOptional

keywordsstring\[\]Optional

weightsobjectOptional

Show properties

Responses

200

Leaderboard created

application/json

Responseobject

Show properties

post

/leaderboards/create

HTTP

HTTPcURLJavaScriptPython

Copy

    POST /v1/leaderboards/create HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Content-Type: application/json
    Accept: */*
    Content-Length: 134
    
    {
      "name": "text",
      "keywords": [\
        "text"\
      ],
      "weights": {
        "engagement": 1,
        "quality_threshold": 1,
        "originality_threshold": 1,
        "relevance_threshold": 1
      }
    }

Test it

200

Leaderboard created

Copy

    {
      "leaderboard_id": "text",
      "name": "text",
      "keywords": [\
        "text"\
      ],
      "weights": {
        "engagement": 1,
        "quality_threshold": 1,
        "originality_threshold": 1,
        "relevance_threshold": 1
      },
      "entries": [\
        {\
          "contributor_id": "text",\
          "rank": 1,\
          "raw_score": 1\
        }\
      ]
    }

### 

[](https://airaa.gitbook.io/docs/products/integrations/leaderboards#get-leaderboards-list)

List Leaderboards

get

https://api.airaa.xyz/v1/leaderboards/list

Retrieve all available leaderboards.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

searchstringOptional

Search term to filter leaderboards by name

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Leaderboards returned

application/json

Responseobject\[\]

Show properties

get

/leaderboards/list

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/leaderboards/list HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Leaderboards returned

Copy

    [\
      {\
        "leaderboard_id": "text",\
        "name": "text",\
        "keywords": [\
          "text"\
        ],\
        "weights": {\
          "engagement": 1,\
          "quality_threshold": 1,\
          "originality_threshold": 1,\
          "relevance_threshold": 1\
        },\
        "entries": [\
          {\
            "contributor_id": "text",\
            "rank": 1,\
            "raw_score": 1\
          }\
        ]\
      }\
    ]

### 

[](https://airaa.gitbook.io/docs/products/integrations/leaderboards#get-leaderboards-id)

Leaderboard Details

get

https://api.airaa.xyz/v1/leaderboards/{id}

Retrieve details for a specific leaderboard.

Authorizations

ApiKeyAuth

ApiKeyAuth

Path parameters

idstringRequired

Unique identifier for the leaderboard

Responses

200

Leaderboard returned

application/json

Responseobject

Show properties

get

/leaderboards/{id}

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/leaderboards/{id} HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Leaderboard returned

Copy

    {
      "leaderboard_id": "text",
      "name": "text",
      "keywords": [\
        "text"\
      ],
      "weights": {
        "engagement": 1,
        "quality_threshold": 1,
        "originality_threshold": 1,
        "relevance_threshold": 1
      },
      "entries": [\
        {\
          "contributor_id": "text",\
          "rank": 1,\
          "raw_score": 1\
        }\
      ]
    }

[PreviousNarratives](https://airaa.gitbook.io/docs/products/integrations/narratives)
[NextDiscovery](https://airaa.gitbook.io/docs/products/integrations/discovery)

---

# Feed & Events | AIRAA

Streams of mentions, narratives, and events

### 

[](https://airaa.gitbook.io/docs/products/integrations/feed-and-events#get-feed-events)

Events Feed

get

https://api.airaa.xyz/v1/feed/events

Retrieve latest ecosystem events.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Events returned

application/json

Responseobject\[\]

Show properties

get

/feed/events

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/feed/events HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Events returned

Copy

    [\
      {\
        "event_id": "text",\
        "type": "text",\
        "timestamp": "2025-09-03T09:42:52.041Z",\
        "source": "text",\
        "data": {\
          "ANY_ADDITIONAL_PROPERTY": "anything"\
        }\
      }\
    ]

### 

[](https://airaa.gitbook.io/docs/products/integrations/feed-and-events#get-feed-mentions)

Mentions Feed

get

https://api.airaa.xyz/v1/feed/mentions

Get real-time feed of raw mentions.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Mentions feed returned

application/json

Responseobject\[\]

Show properties

get

/feed/mentions

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/feed/mentions HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Mentions feed returned

Copy

    [\
      {\
        "mention_id": "text",\
        "contributor_id": "text",\
        "content": "text",\
        "timestamp": "2025-09-03T09:42:52.041Z",\
        "platform": "text",\
        "metrics": {\
          "likes": 1,\
          "comments": 1,\
          "shares": 1\
        }\
      }\
    ]

### 

[](https://airaa.gitbook.io/docs/products/integrations/feed-and-events#get-feed-narratives)

Narratives Feed

get

https://api.airaa.xyz/v1/feed/narratives

Stream of narrative mentions across ecosystems.

Authorizations

ApiKeyAuth

ApiKeyAuth

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of results to return (default: 100, max: 1000)

Default: `100`

offsetintegerOptional

Number of results to skip for pagination (default: 0)

Default: `0`

ecosystemstringOptional

Filter by blockchain ecosystem (e.g., 'ethereum', 'solana', 'polygon')

categorystringOptional

Filter by project category (e.g., 'defi', 'nft', 'gaming')

platformstring · enumOptional

Filter by social platform (e.g., 'twitter', 'discord', 'telegram')

Possible values: `twitter``discord``telegram``reddit``all`

start\_datestring · dateOptional

Start date for filtering results (ISO 8601 format: YYYY-MM-DD)

end\_datestring · dateOptional

End date for filtering results (ISO 8601 format: YYYY-MM-DD)

sort\_bystring · enumOptional

Field to sort results by

Possible values: `mentions``engagement``influence``timestamp``rank`

sort\_orderstring · enumOptional

Sort order (ascending or descending)

Default: `desc`Possible values: `asc``desc`

Responses

200

Narratives feed returned

application/json

Responseobject\[\]

Show properties

get

/feed/narratives

HTTP

HTTPcURLJavaScriptPython

Copy

    GET /v1/feed/narratives HTTP/1.1
    Host: api.airaa.xyz
    X-API-Key: YOUR_API_KEY
    Accept: */*
    

Test it

200

Narratives feed returned

Copy

    [\
      {\
        "mention_id": "text",\
        "narrative_id": "text",\
        "content": "text",\
        "timestamp": "2025-09-03T09:42:52.041Z"\
      }\
    ]

[PreviousDiscovery](https://airaa.gitbook.io/docs/products/integrations/discovery)
[NextStatus](https://airaa.gitbook.io/docs/products/integrations/status)

---

# Aura Boards | AIRAA

The Aura Boards are campaign specific leaderboard that ranks contributors based on their actions across socials and onchain. Each campaign has its own Aura Board, with scoring rules defined by the partner project running it.

The Aura Board serves two purposes:

*   **For contributors**: it shows how actions translate into measurable influence and where they stand compared to others.
    
*   **For projects**: it provides a transparent way to evaluate community engagement and distribute rewards fairly.
    

Interested in running your own campaign? Reachout to us [here](https://t.me/lightwaslost?text=hey%20light%2C%20would%20love%20to%20learn%20more%20about%airaa%campaigns)
.

#### 

[](https://airaa.gitbook.io/docs/products#how-aura-is-calculated)

How Aura is Calculated

Aura is currently built from three data sources: **X, Discord, and onchain activity**. The final scoring weights and criteria are fully modular, allowing each project to decide which actions matter most. This creates a unified leaderboard that reflects contributions across platforms rather than isolating them.

#### 

[](https://airaa.gitbook.io/docs/products#key-components-of-the-aura-board)

Key Components of the Aura Board

*   **Socials**: shows which platforms a contributor is active on
    
*   **Multiplier**: displays the boost earned from on-chain usage or other campaign-defined actions
    
*   **Aura %**: the contributor’s share of total campaign aura
    
*   **Connections**: highlights the contributor’s links to other community members
    

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252F9xdLRTkVrjahI02426DD%252FScreenshot%25202025-08-28%2520at%25201.02.22%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3D9b0cd009-d182-4a9a-8b09-51728d5028df&width=768&dpr=4&quality=100&sign=2a0b48b3&sv=2)

Aura board is in beta and will go through multiple algorithm iterations to filter bots and spam.

[PreviousWhy Airaa exists?](https://airaa.gitbook.io/docs/getting-started/publish-your-docs)
[NextMarket Intelligence](https://airaa.gitbook.io/docs/products/markdown)

Last updated 6 days ago

---

# What is Airaa? | AIRAA

Airaa is an intelligence layer for Web3.

It brings together data from social platforms and onchain activity to make communities, projects, and contributors measurable.

With Airaa you can:

*   Track how narratives form and spread across Twitter, Discord, and blockchains.
    
*   Discover which contributors actually add value in a project.
    
*   Run campaigns with reward pools that incentivise genuine engagement instead of spam.
    
*   Access analytics and APIs that help VCs, protocols, and researchers make better decisions.
    

![](https://airaa.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F238999426-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fdmwne6oUXEkyAPUnE5DZ%252Fuploads%252FETMYmgLH0fEor4LsJp7M%252FScreenshot%25202025-08-28%2520at%252012.58.43%25E2%2580%25AFAM.png%3Falt%3Dmedia%26token%3Dc499ec00-3453-4d7a-a9e3-2d38b49cb55c&width=768&dpr=4&quality=100&sign=55bbc2d&sv=2)

[PreviousWelcome to Airaa 👨‍🌾](https://airaa.gitbook.io/docs)
[NextWhy Airaa exists?](https://airaa.gitbook.io/docs/getting-started/publish-your-docs)

Last updated 6 days ago

---