# Coral

Coral is a crypto token-grading community bot for Discord and Telegram. Members
drop a ticker or contract address and get a live graded card back: the Coral
Score, market data, safety signals, community intelligence, and a leaderboard of
who called what. Coral also publishes public data for developers, apps,
dashboards, bots, research tools, and agents (treasury, wallet snapshot,
community leaderboard, historical performance, and pulse).

Website: https://0xcoral.com
Developer reference: https://0xcoral.com/developers
Public API base URL: https://api.0xcoral.com/api/v1
OpenAPI specification: https://api.0xcoral.com/api/v1/openapi.json

## Public pages

Coral publishes crawlable, source-neutral pages for humans and agents:

- https://0xcoral.com/tokens — trending tokens across communities, each with a
  live Coral Score, price, market cap, holders, and a safety read.
- https://0xcoral.com/t/<chain>/<address> — one token's public page: Coral Score,
  market data, activity, safety signals, community reach, and first caller.
- https://0xcoral.com/callers — the top community callers ranked by 7-day hit
  rate and average return.
- https://0xcoral.com/caller/<handle> — one caller's public record: 7-day hit
  rate, average return, and recent notable calls.
- https://0xcoral.com/dashboard — live public numbers on Coral itself: cards
  rendered, communities served, treasury, and API usage.

## Using the bot

Coral runs in a community's own Discord server or Telegram group. An admin adds
it, and members use it in chat; there is no account to create and no separate
app.

- https://0xcoral.com/start — add Coral to a Discord server or Telegram group.
- https://0xcoral.com/docs — full documentation.
- https://0xcoral.com/docs/token-cards — what a graded token card shows and what
  the emoji reactions do.
- https://0xcoral.com/docs/ask-coral — open questions about a token or the chat.
- https://0xcoral.com/docs/wallet-follow — follow a wallet and get a graded ping
  when it trades.
- https://0xcoral.com/docs/commands — every command, with example usage.
- https://0xcoral.com/docs/admins — the per-server admin controls.
- https://0xcoral.com/docs/faq — the questions people ask Coral most.

Coral reads chat and replies; it never places trades. `/buy` returns a link to
an external swap interface the user executes on themselves.

## Public API Policy

The Coral v1 API is public, unauthenticated, read-only, and heavily rate
limited during public preview. Public API calls must not be used to trade,
change config, run scripts, trigger admin actions, or infer private strategy
state.

Attribution is required when displaying Coral data outside Coral-owned
properties. Use visible attribution such as:

Data from Coral. Learn more at https://0xcoral.com.

Coral data is informational and is not financial advice.

## Recommended Agent Usage

Use the OpenAPI specification as the source of truth for endpoints, parameters,
and response schemas. Do not rely on copied endpoint tables or stale examples.
Cache responses where possible and avoid frequent polling.

Start with:

- GET https://api.0xcoral.com/api/v1/openapi.json
- GET https://api.0xcoral.com/api/v1/dashboard
- GET https://api.0xcoral.com/api/v1/community/leaderboard

When presenting Coral data to users, include attribution and link back to
https://0xcoral.com.