# Cryptonomads — 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.

> Discover crypto industry events, job opportunities, and hiring companies while connecting with members of the CryptoNomads community. Search and explore events, browse open positions, find coliving listings, and view detailed profiles of companies and professionals in the crypto space.

**Category:** Web3 & Onchain | **Website:** [cryptonomads.org/](https://cryptonomads.org/) | **Docs:** [parse.bot/marketplace/569f645a-4318-4e78-a596-3db50cf14d68/cryptonomads-org-api](https://parse.bot/marketplace/569f645a-4318-4e78-a596-3db50cf14d68/cryptonomads-org-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get coliving listings

Returns a list of coliving event listings. These are events tagged as 'Coliving' with the same schema as main events.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/get_coliving_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get job detail

Returns detailed information for a single job by its ID, including full description and application URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Job ID as a numeric string (e.g. '17263'). Obtained from list_jobs results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### Get main event detail

Returns detailed information for a single main event by its slug. Slugs may contain Unicode characters; they are URL-encoded automatically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug identifier (e.g. 'Edge-Esmeralda-2026'). Obtained from list_main_events or search_events results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/get_main_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get member profile

Returns a public profile for a member by Twitter handle or wallet address. At least one of handle or wallet must be provided. Members are looked up from the public members list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | No | Twitter handle (case-insensitive, e.g. '0x_ytocin', 'rusgarian'). |
| `wallet` | string | No | Ethereum wallet address (e.g. '0x5090BB37446f5FB8779777732e0Ab679870EeAB0'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/get_member_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>","wallet":"<string>"}'
```

### Get popular events

Returns the top 10 most popular main events based on user attendance count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/get_popular_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get side event group detail

Returns detailed information for a side event group by its slug, including the group metadata, individual side events, and companies attending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Side event group slug (e.g. 'ETHConfEvents2026'). Obtained from list_side_event_groups results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/get_side_event_group_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List companies hiring

Returns a list of companies currently hiring, sorted by number of open positions descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/list_companies_hiring \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List event companies attending

Returns a list of companies attending a specific side event group. Companies include name, logo, handle, and tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Side event group slug (e.g. 'ETHConfEvents2026'). Obtained from list_side_event_groups results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/list_event_companies_attending \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List jobs

Returns a list of job listings. Supports filtering by location, job type, work arrangement, and keyword query. Returns all jobs when no filters are provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `arrangement` | string | No | Filter by work arrangement (e.g. 'Remote', 'on-site'). |
| `job_type` | string | No | Filter by job type (e.g. 'full-time', 'Contract'). |
| `location` | string | No | Filter by city or country (e.g. 'Mumbai', 'USA'). |
| `query` | string | No | Search by position title or company name. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/list_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arrangement":"<string>","job_type":"<string>","location":"<string>","query":"<string>"}'
```

### List main events

Returns all main crypto events. Supports client-side filtering by chain, event type, location, and keyword query. Returns all events when no filters are provided. Results are not paginated — the full event calendar is returned in one response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | No | Filter by blockchain chain (e.g. 'Ethereum', 'Solana', 'Multichain'). Matches against event chain tags. |
| `event_type` | string | No | Filter by event type (e.g. 'Conference', 'Hackathon', 'Coliving'). |
| `location` | string | No | Filter by location. Matches against city, country, or region fields (e.g. 'Europe', 'Prague', 'USA'). |
| `query` | string | No | Search keyword matched against event name and description. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/list_main_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"<string>","event_type":"<string>","location":"<string>","query":"<string>"}'
```

### List members

Returns a list of all public member IDs (Airtable-style record IDs). Use get_member_profile to retrieve detailed information for a specific member.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/list_members \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List side event groups

Returns a list of side event group pages with metadata including location, dates, and number of events in each group.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/list_side_event_groups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search events

Search for main events by keyword. Matches against event name and description fields. Returns full event objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'ethereum', 'bitcoin', 'solana'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-cryptonomads-org-api-569f645a/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```