# Esp Ethereum — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access information about Ethereum Foundation's grant programs, including open funding rounds, RFPs, and application details to find grants that match your project's needs. Browse blog posts, wishlist items, and office hours schedules to stay updated on ecosystem support opportunities.

**Category:** Web3 & Onchain | **Website:** [esp.ethereum.foundation/](https://esp.ethereum.foundation/) | **Docs:** [parse.bot/marketplace/baff1025-98b8-453d-abf7-2be0a9554bfb/esp-ethereum-foundation-api](https://parse.bot/marketplace/baff1025-98b8-453d-abf7-2be0a9554bfb/esp-ethereum-foundation-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_about_esp

Fetches information about ESP, its mission, and team sections. Returns a summary of the program and detailed descriptions of each team (Overview, Grant Management, Funding Coordination).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_about_esp \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_applicants_overview

Fetches the How to Apply overview page, returning ESP's mission and scope text, the step-by-step application process, and FAQ items. The process array is ordered sequentially from Browse through Complete.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_applicants_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_blog_post_detail

Fetches full content of a specific blog post by its URL path. Accepts paths with or without the /en/ prefix and trailing slash. Returns the complete markdown content, frontmatter metadata, and canonical URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | URL path of the blog post in format YYYY/MM/DD/slug. Accepts variations: '/en/YYYY/MM/DD/post-slug/', '/YYYY/MM/DD/post-slug', or 'YYYY/MM/DD/post-slug'. Obtain from get_blog_posts results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_blog_post_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### get_blog_posts

Fetches blog posts from the Ecosystem Support Program category on the Ethereum blog. Returns posts with frontmatter metadata (title, date, author, category, image) and content preview text. Posts are ordered by date descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_blog_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_domain_dropdown_options

Returns the complete list of available options for the Domain dropdown field in the Office Hours application form. These represent the categories of work ESP supports.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_domain_dropdown_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_office_hours_form_fields

Returns all form fields with their metadata for the Office Hours application form, including field names, types, labels, required status, help text, and options for dropdowns/radios. Each field object describes one input in the form; dropdown fields include their full options array.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_office_hours_form_fields \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_office_hours_info

Fetches the Office Hours informational page, returning sections including Summary, Eligibility, Process, What we offer, What we DON'T offer, Before submitting, and FAQ. Each section key maps to its full text content.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_office_hours_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_open_rounds

Fetches all currently active grant rounds. Returns an array which may be empty when no rounds are currently open. Each round object includes slug, name, description, tags, and date fields.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_open_rounds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_profile_type_options

Returns available options for the Profile Type dropdown field in the Office Hours application form.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_profile_type_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_rfps

Fetches all Requests for Proposals (RFPs) with their details including name, description, tags, requirements, resources, and open/close dates. Each RFP object contains Salesforce-sourced fields.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_rfps \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_round_details

Fetches full details for a specific grant round by its slug. Returns the round's frontmatter metadata (name, description, tags, dates), compiled MDX page content, and associated RFP items. Returns stale_input with kind input_not_found if the slug does not match any known round.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Round slug identifier, obtained from get_open_rounds results (e.g. 'phdfp26'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_round_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_wishlist

Fetches the ESP wishlist of project types that ESP is seeking proposals for. Each item includes name, description, tags, resources, and other metadata fields. Returns an empty array when no wishlist items are currently published.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esp-ethereum-foundation-api-baff1025/get_wishlist \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
