> For the complete documentation index, see [llms.txt](https://docs.rubyscore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rubyscore.io/for-partners/rubyscore-api/about-api.md).

# About API

Build faster without running your own nodes. RubyScore provides a **single API across 50+ EVM chains** and a **business-oriented analytics layer** to understand behavior, activate the right users, and automate growth.

***

#### 1) RubyScore On-Chain Data API

For engineering and product teams.\
Query wallets, tokens, contracts, and events **in a unified schema across networks**. Perfect for backends, dApps, bots, internal tools, and dashboards.

#### 2) RubyScore Behavior & Growth Analytics

For growth, ops, and analysts.\
Segment users by **real on-chain activity**, build dynamic cohorts, track cross-protocol journeys, and measure campaign impact.

> Optionally plug in **MRS**, **PoH ID**, and **Score Level** as ready-to-use traits for targeting, gating, and anti-fraud.

***

### What you can do with the API

* **Wallet snapshots & timelines:** balances, transfers, unique contract interactions, active days/weeks/months, gas spent, volumes.
* **Contract & token telemetry:** event streams (ERC-20/721/1155), function calls, holders, counterparties.
* **Your own scoring:** build quality/value models on normalized multi-chain data.
* **Cohorts & segmentation:** create audiences by behavior (e.g., “active 7/14 days, ≥5 unique contracts, volume ≥ $500”).
* **Quality filters:** exclude low-signal traffic via your own thresholds or reputation traits (MRS / PoH presence / Levels).
* **Personalized UX:** dynamic allowlists, reward rules, and access tiers directly in your app.

***

### How RubyScore helps

* **No nodes or indexers required:** we handle ingestion, indexing, and normalization; you hit clean, consistent endpoints.
* **Real-time streams:** for automations, reward triggers, and safety rules with minimal latency.
* **50+ EVM chains:** Ethereum, Optimism, Arbitrum, Base, and more — coverage keeps expanding.

***

### Customization (on request — “any blockchain parameter you need”)

We adapt the API, analytics, and rules to your goals and ecosystem specifics.&#x20;

***

RubyScore API is a **practical growth stack** for Web3. Target and reward the users who truly create value — powered by verifiable on-chain data, custom segments, and durable reputation signals.\ <br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.rubyscore.io/for-partners/rubyscore-api/about-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
