# Web3 — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Search and explore Web3 job listings with detailed information including salary data, remote opportunities, and company intelligence across the ecosystem. Filter positions by tags, view comprehensive job details, and access industry salary reports to make informed career decisions in the Web3 space.

**Category:** Jobs | **Website:** [web3.career/](https://web3.career/) | **Docs:** [parse.bot/marketplace/e485a330-d24c-4c62-8ad9-6980e60b87ad/web3-career-api](https://parse.bot/marketplace/e485a330-d24c-4c62-8ad9-6980e60b87ad/web3-career-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/web3/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get company jobs

Fetch all job listings for a specific company by its URL slug. Returns paginated job listings posted by the company. The slug is derived from the company URL returned by get_web3_companies (e.g., 'binance' from /web3-companies/binance).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | The URL slug of the company (e.g., binance, crypto-com, coinbase). Available from get_web3_companies results. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-company-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>","page":"<integer>"}'
```

### Get intelligence report

Fetch the Web3 Career Intelligence Report content and statistics. Returns the report title, full text content, key statistical findings, and a link to the embedded Google Slides presentation. This is a single static report page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-intelligence-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get job detail

Fetch full details for a single job listing by URL. Returns the job title, company name, full description text, salary range, and application link. The URL is obtained from job listing endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL of the job listing on web3.career (e.g., https://web3.career/senior-fullstack-engineer-backend-focus-rugsdotfun/150325). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-job-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get job listings

Fetch general job listings from the homepage with pagination. Returns Web3 job postings including title, company, location, salary, tags, and posting date. Results are ordered by recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-job-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get jobs by tag

Fetch job listings filtered by a skill or category tag. Returns paginated results for the given tag. Each tag corresponds to a URL path segment on web3.career (e.g., 'backend' maps to /backend-jobs).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `tag` | string | Yes | The skill or category tag to filter jobs by. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-jobs-by-tag \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","tag":"<string>"}'
```

### Get remote jobs

Fetch remote-only job listings with pagination. Filters to positions explicitly tagged as remote work opportunities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-remote-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get web3 companies

Fetch a paginated list of Web3 companies hiring on the platform. Each company includes its name and profile page URL. The company slug from the URL can be used with get_company_jobs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-web3-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get web3 salaries

Fetch average salaries for various Web3 roles. Returns a list of roles with their average salary and a link to the role's detail page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/get-web3-salaries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search jobs

Search for jobs using a keyword query. Returns paginated job listings matching the search term. The search matches against job titles, descriptions, and companies. Results may include broadly related listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | The search keyword (e.g., Solidity, London, Bitcoin, frontend, Rust). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/web3/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.