# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/cryptonomads/`
**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 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/credits/cryptonomads/get-coliving-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/get-job-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/get-main-event-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/get-member-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/get-popular-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/get-side-event-group-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/list-companies-hiring \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/list-event-companies-attending \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/list-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/list-main-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/list-members \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/list-side-event-groups \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/cryptonomads/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.