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

> 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.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.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.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.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.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.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.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.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.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.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.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.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.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.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>"}'
```
