---
name: relai.fi
description: relai.fi provides two data retrieval endpoints focused on Bitcoin ordinals and project discovery: one for fetching detailed SAT-level metadata by numeric ID, and one for listing projects indexed by the Relai platform. It does not support trading, price feeds, or on-chain transactions.
host: relai.fi
---

# relai.fi

relai.fi is a data API host serving agents that need Bitcoin ordinal SAT metadata or Relai-indexed project discovery. It targets use cases involving ordinal rarity analysis and project enumeration, not financial operations or multi-asset queries. Its scope is narrow and read-only.

## When to use this host

Use relai.fi when an agent needs Bitcoin ordinal SAT rarity metadata for a known numeric SAT ID, or when it needs to enumerate projects indexed by the Relai platform. Do not use this host for real-time price feeds, token swaps, on-chain transaction submission, or bulk SAT searches by rarity category — those require dedicated DeFi or blockchain data hosts. If the agent needs to search SATs by rarity class rather than by a specific ID, this host cannot fulfill that need.

## Capabilities

### Ordinal SAT Metadata

Retrieves detailed on-chain and rarity metadata for a specific Bitcoin SAT by numeric ID, including charm classifications, rarity scores, and inscription history.

- **`fetch-relay-sat-record`** — Retrieves a Bitcoin ordinal SAT record by numeric ID, returning rarity metadata, on-chain output data, and inscription history.

### Project Discovery

Returns the list of projects indexed by Relai, enabling agents to enumerate and look up available project metadata from the Relai platform.

- **`search-relai-projects`** — Searches and returns project metadata indexed by Relai for a given relay endpoint.

## Workflows

### Project-to-SAT Rarity Lookup

*Use when an agent needs to discover Relai-indexed projects and then retrieve detailed SAT-level rarity data for specific SAT IDs associated with those projects.*

1. **`search-relai-projects`** — Enumerate available Relai-indexed projects to identify relevant project metadata and any associated SAT IDs of interest.
2. **`fetch-relay-sat-record`** — Fetch detailed rarity, ordinal, and on-chain metadata for a specific SAT ID surfaced from the project discovery step.

## Skill reference

### `fetch-relay-sat-record`

**Relay SAT Fetch** — Retrieves a Bitcoin ordinal SAT record by numeric ID, returning rarity metadata, on-chain output data, and inscription history.

*Use when:* Use when an agent needs detailed rarity, ordinal, and on-chain metadata for a specific Bitcoin SAT number, including palindrome/vintage/fibonacci classifications and rarity score breakdown.

*Not for:* Do not use for listing multiple SATs or searching by rarity category; this endpoint fetches a single SAT record by ID only.

**Inputs:**

- `id` (integer, required) — The numeric SAT number to look up. Passed as a path parameter in the URL.

**Returns:** Returns an ord_data object with on-chain UTXO info and rare_sat_info flags, a rarity_score object with score=993 and label MYTHIC, and sql_metadata with creation and inscription history for the requested SAT.

**Example:** `GET https://relai.fi/api/relay/1770567626782/api/sat/1`

---

### `search-relai-projects`

**Relai Projects Search** — Searches and returns project metadata indexed by Relai for a given relay endpoint.

*Use when:* Use when an agent needs to discover or look up projects indexed by Relai, such as retrieving a list of available projects with their metadata and discovery information.

*Not for:* Do not use for real-time price feeds, token swaps, or on-chain transaction data; this endpoint returns project index metadata only.

**Returns:** Returns an array of project records with metadata and discovery info indexed by Relai.

**Example:** `GET https://relai.fi/api/relay/1770205426261/projects/search`

---