Nostr Event Kinds — Complete Reference

Every event kind and what it does.

Event Classification#

Range	Behavior	Storage
0	Replaceable (metadata)	Latest only
1	Regular	Forever
2	Regular (deprecated)	Forever
3	Replaceable (contacts)	Latest only
4	Regular	Forever
5	Regular (deletion)	Forever
6	Regular (repost)	Forever
7	Regular (reaction)	Forever
1000–9999	Regular	Forever
10000–19999	Replaceable	Latest per (pubkey, kind)
20000–29999	Ephemeral	Not stored
30000–39999	Addressable	Latest per (pubkey, kind, d-tag)

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#

Kind	Purpose
40	Channel Creation
41	Channel Metadata
42	Channel Message
43	Hide Message
44	Mute User

Long-Form & Media#

Kind	Type	NIP
20	Picture	68
21	Video (horizontal)	71
22	Video (vertical/shorts)	71
30023	Long-form Article	23
1311	Live Chat Message	53
1222	Voice Message	A0

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#

Kind	Type	NIP
9734	Zap Request	57
9735	Zap Receipt	57
9041	Zap Goal	75
9321	Nutzap (ecash)	61
13194	NWC Wallet Info	47
23194	NWC Request	47
23195	NWC Response	47

Ecash (NIP-60)#

Kind	Purpose
7374	Reserved Cashu Tokens
7375	Cashu Wallet Tokens
7376	Cashu Wallet History

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#

Kind	Type
31990	Handler Information
31989	Handler Recommendation
5000–5999	DVM Job Request
6000–6999	DVM Job Result
7000	DVM Job Feedback
31339	Agent Metadata

Community & Groups#

Kind	Purpose
34550	Community Definition
4550	Community Post Approval
28934	Join Request
28935	Invite Request
28936	Leave Request
9000–9030	Group Control Events

Other Notable Kinds#

Kind	Purpose	NIP
1984	Reporting	56
1985	Labels	32
1986	Relay Reviews	—
1987	AI Embeddings	NKBIP-02
1063	File Metadata	94
1068	Poll	88
1018	Poll Response	88
1111	Comment	22
1337	Code Snippet	C0
1040	OpenTimestamps	03
31922	Calendar Event	52
31923	Calendar RSVP	52
31925	Calendar Exception	52
9802	Highlights	84
27235	HTTP Auth	98
22242	Client Auth	42
1617	Patches	34
1621	Issues	34
2003	Torrent	35
2004	Torrent Comment	35

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)