# OnchainDiary — Agent Authentication & Access

Onchain Diary is an on-chain risk intelligence platform. Content is publicly accessible; the Risk Intelligence API has a free tier (score + level) and a paid tier (full signal breakdown via x402 micropayments).

## Markdown Content Negotiation

Send `Accept: text/markdown` to receive markdown versions of any content page instead of HTML.

```
curl -H "Accept: text/markdown" https://theonchaindiary.com/glossary/airdrop/
```

This returns the raw markdown source (frontmatter stripped), making it ideal for RAG pipelines and AI agents.

## Content Endpoints

- **Risk API Docs**: `https://theonchaindiary.com/developers/`
- **Glossary**: `https://theonchaindiary.com/glossary/` (120+ terms)
- **Tools**: `https://theonchaindiary.com/tools/` (calculators)
- **Articles**: `https://theonchaindiary.com/articles/`
- **API Catalog**: `https://theonchaindiary.com/.well-known/api-catalog`
- **Agent Skills**: `https://theonchaindiary.com/.well-known/agent-skills/index.json`
- **MCP Server Card**: `https://theonchaindiary.com/.well-known/mcp/server-card.json`

## API Endpoints

- **Address Risk**: `GET /api/v1/risk/address/{address}?chain={chain}`
- **Token Risk**: `GET /api/v1/risk/token/{address}?chain={chain}`
- **Gas Price**: `GET /api/v1/gas?chain={chain}`

Free tier returns risk score + level. Paid tier (x402 micropayment) returns full signal breakdown.

## Direct Markdown Access

Append `/index.md` to any content URL:

```
https://theonchaindiary.com/glossary/airdrop/index.md
https://theonchaindiary.com/articles/understanding-gas-fees/index.md
```

## Content Usage

- **Search indexing**: Yes
- **AI training**: No
- **AI input (RAG/query)**: Yes

See `robots.txt` for Content-Signal directives.

## Contact

- **General**: hi@theonchaindiary.com
- **Security**: See `.well-known/security.txt`
- **GitHub**: [respectevery01/astro-onchaindiary](https://github.com/respectevery01/astro-onchaindiary)