# /Feed

## Overview

The `/feed` endpoint retrieves a feed of events from authors that a specified user follows. It returns an array of events along with the profiles of the authors involved.

## Endpoint Details

* **URL**: `/feed`
* **Method**: GET
* **Auth Required**: No
* **Permissions Required**: None

## Request Parameters

| Parameter | Description                                                                                   | Required |
| --------- | --------------------------------------------------------------------------------------------- | -------- |
| `pubkey`  | The public key of the user whose feed is being requested.                                     | Yes      |
| `limit`   | The maximum number of events to return. Defaults to 20 if not provided.                       | No       |
| `kinds`   | Comma-separated list of event kinds to filter by. Defaults to all kinds if not provided.      | No       |
| `until`   | Unix timestamp in seconds. If provided, fetch only events that were created before this time. | No       |

## Response Schema

The response is a JSON object with the following structure:

```json
{
  "pubkey": "requesting_user_pubkey",
  "events": [
    {
      "id": "event_id",
      "pubkey": "author_pubkey",
      "created_at": 1234567890,
      "kind": 1,
      "tags": [],
      "content": "Event content",
      "sig": "event_signature"
    }
  ],
  "profiles": {
    "author_pubkey": {
      "id": "profile_event_id",
      "pubkey": "author_pubkey",
      "created_at": 1234567890,
      "kind": 0,
      "tags": [],
      "content": "Profile content",
      "sig": "profile_signature"
    }
  }
}
```

* `pubkey`: The public key of the user requesting the feed.
* `events`: An array of events from authors the user follows, sorted by creation time in descending order.
* `profiles`: A map of author profiles for all events in the feed, keyed by pubkey.

## Example Call

```bash
curl -X GET "https://huddlers-ovduv.ondigitalocean.app/feed?pubkey=82341f882b6eabcd2ba7f1ef90aad961cf074af15b9ef44a09f9d2a8fbfbe6a2&limit=5&kinds=1,6"
```

## Notes

* Events are sorted by creation time, with the most recent events first.
* To fetch the preceding batch of events in a feed, you can apply the `until` query parameter. Set its value to the `created_at` timestamp of the last event in the preceding batch.

## Error Responses

* **400 Bad Request**: If any of the parameters are invalid.
* **404 Not Found**: If the user's follow list cannot be found.
* **500 Internal Server Error**: If there's an issue processing the request.