grimoire.rocks

{
  "type": "object",
  "properties": {
    "kinds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Event kinds to request."
    },
    "authors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Hex pubkeys, not npubs. \"$me\" and \"$contacts\" resolve to the active account and the people it follows."
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Hex event ids, not note1 or nevent."
    },
    "since": {
      "type": "number",
      "description": "Unix seconds; only events at or after this time."
    },
    "until": {
      "type": "number",
      "description": "Unix seconds; only events at or before this time."
    },
    "search": {
      "type": "string",
      "description": "NIP-50 full-text query. Sent to the user's own search relays, which is the only place it means anything — most relays ignore the field and answer with their newest events instead."
    },
    "tags": {
      "type": "object",
      "description": "Single-letter tag filters: {\"t\": [\"nostr\"]} for a hashtag, {\"e\": [\"<hex>\"]} for replies to an event, {\"p\": [\"$me\"]} for events tagging the active account.",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "limit": {
      "type": "number",
      "description": "How many events you want. Ask for what the question needs — five to skim, more to summarise a thread or a week. Defaults to 5, hard bound 500."
    },
    "relays": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Leave this out. grimoire selects relays itself from the user's NIP-65 lists and the pointers involved. Pass a URL only when the user named one."
    }
  }
}