> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elata.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> REST API for the Elata App Store at app.elata.bio.

The Elata App Store exposes a REST API at `https://app.elata.bio/api`. This tab is the source of truth for that surface — every page is generated from a single OpenAPI 3.1 spec at [`api-reference/openapi.yaml`](https://github.com/elata-biosciences/docs/blob/main/api-reference/openapi.yaml).

It is the API surface third-party builders need to discover apps, run launch preflight, render market widgets, show user portfolios, surface claimable rewards, and bootstrap SDKs against the right contracts.

For the higher-level integration narrative (iframe embedding, on-chain reads, transaction patterns), see [Builders → API Overview](/builders/api-overview).

***

## Status legend

Every operation in this reference carries an `x-elata-status`:

| Status       | Meaning                                                                                                                       |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| **stable**   | Implemented today on `app.elata.bio/api`. Safe to depend on.                                                                  |
| **proposed** | Designed in the spec but **not yet implemented**. The spec is the contract the backend will build against. Subject to change. |
| **planned**  | Acknowledged but not yet designed. Reserved namespace.                                                                        |

The currently `stable` operations are:

* `GET /apps`
* `GET /apps/{tokenAddress}`
* `GET /prices`

Everything else in this tab is `proposed`.

***

## Base URL

```
https://app.elata.bio/api
```

***

## Authentication

Most reads are public. Personalized endpoints under **Portfolio** and **Rewards** require a SIWE-issued JWT bearer token.

```http theme={null}
Authorization: Bearer <siwe-jwt>
```

The token is obtained via [Sign-In With Ethereum](https://eips.ethereum.org/EIPS/eip-4361) against `app.elata.bio`. The JWT's `sub` claim is the wallet address; requests whose path `{address}` does not match the `sub` are rejected.

***

## Rate limits

| Endpoint class | Limit       |
| -------------- | ----------- |
| Read endpoints | 100 req/min |
| Heavy queries  | 10 req/min  |

For heavy on-chain reads, bring your own RPC provider in production (Alchemy, Infura, QuickNode).

***

## Sections

<CardGroup cols={2}>
  <Card title="Apps" href="/api-reference/apps/list">
    Discovery, detail, search, holders, activity.
  </Card>

  <Card title="Preflight" href="/api-reference/preflight/launch">
    Validate a launch before sending a transaction.
  </Card>

  <Card title="Market" href="/api-reference/market/elta">
    Prices, candles, bonding-curve state, leaderboards.
  </Card>

  <Card title="Portfolio" href="/api-reference/portfolio/get">
    Per-wallet holdings, history, P\&L.
  </Card>

  <Card title="Rewards" href="/api-reference/rewards/get">
    Claimable rewards, programs, claim payloads.
  </Card>

  <Card title="Config" href="/api-reference/config/get">
    Runtime config for SDKs and AI agents.
  </Card>
</CardGroup>

***

## On-chain interfaces

For Solidity contract interfaces, ABIs, and deployed addresses:

* [elata-protocol](https://github.com/elata-biosciences/elata-protocol) — Solidity source and deployment scripts
* [elata-appstore](https://github.com/elata-biosciences/elata-appstore) — Frontend reference, including ABIs in `src/abi/`
* [Resources → Smart Contracts](/resources/smart-contracts) — current deployed addresses