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)