# Yaps Open Protocol

Yaps serve as a public good for recognizing, rewarding, and tracking attention. Fully accessible through our public API endpoint, Yaps allow any builder to access and build on top of tokenized attention permissionlessly.

Since the data went live in December 2024, numerous teams (eg Berachain, Story, Fantasy Top) have already been using it for various use cases, including SocialFi developments, reward distribution, and more.

For teams and developers who are keen to build on top of Yaps and looking for custom integrations, or additional features beyond what is publicly available, please get in touch [here](https://discord.gg/kaitoai). 

## Getting Started with Yaps API

The following section provides information on access to Yaps data via Kaito AI’s API.

Please note that the default rate limit is 100 calls every 5 minutes. If you have more bespoke needs, feel free to contact us [here](https://discord.gg/kaitoai). 

#### **Yaps Endpoint**

```jsx
https://api.kaito.ai/api/v1/yaps
```

This endpoint returns the Yaps score of the given user. 

#### **Parameters**

Note: either of **`user_id`**or **`username`** must be specified.

* **`user_id`** (optional, recommended): The 𝕏 account user id of the particular user you want to get Yaps data for. (Users can get 𝕏 user id via external tools)
* **`username`** (optional): The 𝕏 account user handle of the particular user you want to get Yaps data for.

#### **Example**

```bash
curl -X GET 'https://api.kaito.ai/api/v1/yaps?username=VitalikButerin'
```

#### **Response**

```json
{
  "user_id": "295218901",
  "username": "VitalikButerin",
  "yaps_all": 3569.71215890904,
  "yaps_l24h": 0,
  "yaps_l48h": 0,
  "yaps_l7d": 0,
  "yaps_l30d": 3569.71215890904,
  "yaps_l3m": 3569.71215890904,
  "yaps_l6m": 3569.71215890904,
  "yaps_l12m": 3569.71215890904
}
```

## Getting Started with Yaps Onchain

Yaps data is available onchain, powered by EAS on Base. It is fully composable and permissionless for anyone to integrate into onchain applications and protocols.

Note that onchain Yaps are tied to a X account's username and Yaps score only; there is no direct linkage to wallet addresses. 

More information available [here](https://x.com/KaitoAI/status/1876254661834871281). 

<figure><img src="/files/77rd9Lo0mNmowWrdRP6o" alt=""><figcaption><p>Fully composable, permissionless public good</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kaito.ai/kaito-yaps-tokenized-attention/yaps-open-protocol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.