• Nostr Event Kinds — Complete Reference
  • Event Classification
  • Core Kinds
    • Kind 0 — User Metadata
    • Kind 1 — Text Note (Short-form)
    • Kind 2 — Recommend Relay (deprecated)
    • Kind 3 — Contact List (Follows)
  • Messaging Kinds
    • Kind 4 — Encrypted DM (DEPRECATED)
    • Kind 14 — Direct Message (NIP-17)
    • Kind 15 — File Message
    • Kind 1059 — Gift Wrap
    • Kind 24 — Public Message (NIP-A4)
  • Social Kinds
    • Kind 5 — Event Deletion
    • Kind 6 — Repost
    • Kind 7 — Reaction
    • Kind 16 — Generic Repost
  • Channel Kinds
  • Long-Form & Media
    • Kind 30023 — Article
  • Bitcoin & Lightning
  • Ecash (NIP-60)
  • Replaceable / Addressable Sets
    • Kind 10000 — Mute List
    • Kind 10001 — Pin List
    • Kind 10002 — Relay List Metadata
    • Kind 10003 — Bookmark List
    • Kind 10004 — Communities List
    • Kind 10006 — Blocked Relays
    • Kind 10015 — Interests List
    • Kind 10030 — Emoji List
    • Kind 10050 — DM Relay List
    • Kind 30000 — Follow Sets
    • Kind 30001 — Curation Sets (deprecated)
    • Kind 30002 — Relay Sets
    • Kind 30003 — Bookmark Sets
    • Kind 30004 — Curation Sets
    • Kind 30009 — Badge Definition
    • Kind 30008 — Profile Badges
  • Agent & DVM Kinds
  • Community & Groups
  • Other Notable Kinds
  • Quick Type Reference

§Nostr Event Kinds — Complete Reference

Every event kind and what it does.

§Event Classification

§Core Kinds

§Kind 0 — User Metadata

{
  "kind": 0,
  "content": "{\"name\":\"Bob\",\"about\":\"Bitcoiner\",\"picture\":\"https://...\",\"nip05\":\"bob@nostr.com\",\"lud16\":\"bob@getalby.com\",\"banner\":\"https://...\"}"
}

Replaceable. Latest per pubkey. Lifeblood of profiles.

§Kind 1 — Text Note (Short-form)

{
  "kind": 1,
  "content": "Hello Nostr!",
  "tags": [["t", "introductions"]]
}

The tweet/post. Threaded via e tags per NIP-10.

§Kind 2 — Recommend Relay (deprecated)

{
  "kind": 2,
  "content": "wss://relay.damus.io"
}

Was for relay recommendations. Use kind 10002 instead.

§Kind 3 — Contact List (Follows)

{
  "kind": 3,
  "tags": [
    ["p", "<pubkey1>", "wss://relay.damus.io", "Alice"],
    ["p", "<pubkey2>", "", "Bob-the-great"]
  ]
}

Replaceable. Social graph with optional petnames and relay hints.

§Messaging Kinds

§Kind 4 — Encrypted DM (DEPRECATED)

Legacy encrypted direct message. Used NIP-04. Don’t use.

§Kind 14 — Direct Message (NIP-17)

Modern private DM. NIP-44 encrypted, NIP-59 gift wrapped.

§Kind 15 — File Message

Like kind 14 but for files. Encrypted file transfer.

§Kind 1059 — Gift Wrap

Encrypted envelope. Wraps kind 14, 15, or any inner event.

§Kind 24 — Public Message (NIP-A4)

Unencrypted public message to a specific pubkey.

§Social Kinds

§Kind 5 — Event Deletion

Requests relay to delete an event. Tags the event to delete.

["e", "<event-id-to-delete>"]

§Kind 6 — Repost

Shares another event. e tag references the original.

§Kind 7 — Reaction

Emoji reaction. Content = 👍, ❤️, 🤙, or +/-.

§Kind 16 — Generic Repost

Repost with type classification (NIP-18).

§Channel Kinds

§Long-Form & Media

§Kind 30023 — Article

{
  "kind": 30023,
  "created_at": 1700000000,
  "tags": [
    ["d", "my-article-slug"],
    ["title", "My Article Title"],
    ["summary", "One-liner summary"],
    ["published_at", "1700000000"],
    ["image", "https://..."],
    ["t", "bitcoin"]
  ],
  "content": "# Markdown Content\n\nFull article body..."
}

Addressable. d tag = slug. Same d publishes an update. Markdown content.

§Bitcoin & Lightning

§Ecash (NIP-60)

§Replaceable / Addressable Sets

§Kind 10000 — Mute List

People and hashtags you’ve muted.

§Kind 10001 — Pin List

Pinned posts on your profile.

§Kind 10002 — Relay List Metadata

["r", "wss://relay.example.com"]
["r", "wss://write-only.relay", "write"]
["r", "wss://read-only.relay", "read"]

§Kind 10003 — Bookmark List

Saved events.

§Kind 10004 — Communities List

Communities you’re part of.

§Kind 10006 — Blocked Relays

Relays you’ve blocked.

§Kind 10015 — Interests List

Topics you’re interested in.

§Kind 10030 — Emoji List

Custom emojis for reactions.

§Kind 10050 — DM Relay List

["relay", "wss://dm-relay.example.com"]

Where to send DMs to reach you.

§Kind 30000 — Follow Sets

Curated follow lists (e.g., “Bitcoin devs”, “Artists”).

§Kind 30001 — Curation Sets (deprecated)

Was generic list. Use specific kinds.

§Kind 30002 — Relay Sets

Curated relay recommendations.

§Kind 30003 — Bookmark Sets

Curated bookmarks.

§Kind 30004 — Curation Sets

Curated content collections.

§Kind 30009 — Badge Definition

Define a badge.

§Kind 30008 — Profile Badges

User’s badge collection.

§Agent & DVM Kinds

§Community & Groups

§Other Notable Kinds

§Quick Type Reference

Regular:    1000–9999  → stored forever
Replaceable: 10000–19999 → latest wins
Ephemeral:  20000–29999 → never stored
Addressable: 30000–39999 → latest per (pubkey, kind, d)