⚛RareMatter
Get started

Docs · Guides · Reference

Docs

Learn it once.

Short guides with real commands. No fluff, no 40-minute videos.

Guide · updated 2026-09-26

API tokens

Call the agent from your own code with X-RM-Token.

Anything the site can do, your code can do: one token, one endpoint, JSON in and out.

Authenticate

Copy your token from Dashboard → API token. Send it as X-RM-Token or Authorization: Bearer. Regenerating kills the old token instantly — update your CLI with rm login.

Run the agent

curl -X POST https://rarematter.tech/api/agent.php \
  -H "X-RM-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"build a cron parser","mode":"build"}'

The reply carries reply, model, provider, and your fresh atoms_left. Anonymous calls work too (fair per-IP limits); accounts spend Atoms and persist runs.

List models

GET /api/models.php returns the live free pool and the gated Pro list, plus your plan and key status — poll it instead of hardcoding model IDs.