Concepts #

Before diving into endpoints, it helps to have the mental model that the rest of this documentation assumes.

• Farcaster identity (FIDs) — what an FID is, how custody works, how Hypersnap resolves it.
• Signed operations (EIP-712) — how management requests (webhooks, mini-app registration) are authenticated using the FID's custody key.
• JSON Farcaster Signatures (JFS) — the Ed25519 envelope Farcaster clients use to report mini-app token events.
• Pagination & cursors — the next.cursor contract used across list endpoints.
• Rate limits — what the server enforces and what it doesn't.
• Errors — HTTP status codes and response shapes you should expect.

None of these are long reads — you can skim them in a few minutes and come back as a reference when something in the endpoint pages doesn't make sense.