# Halborn — 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 security audit reports, detailed findings, and expert insights from Halborn to research which companies have been audited and review their security assessments. Search blog posts and whitepapers to stay informed on the latest security research and industry best practices.

**Category:** Web3 & Onchain | **Website:** [halborn.com/](https://halborn.com/) | **Docs:** [parse.bot/marketplace/ab2836a1-786d-4a5c-a583-9be655ee5be5/halborn-com-api](https://parse.bot/marketplace/ab2836a1-786d-4a5c-a583-9be655ee5be5/halborn-com-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-halborn-com-api-ab2836a1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_audit_detail

Get detailed information about a specific audit including security findings summary, engagement dates, and introduction text. Requires both company_slug and audit_slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `audit_slug` | string | Yes | The slug of the audit (e.g. 'mpt-dex-ef128a'), from get_audits_by_company.audits[*].audit_slug. |
| `company_slug` | string | Yes | The slug of the company (e.g. 'ripple'), from list_audited_companies.companies[*].company_slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-halborn-com-api-ab2836a1/get_audit_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audit_slug":"<string>","company_slug":"<string>"}'
```

### get_audits_by_company

Fetch all audits for a specific company identified by its slug. Returns audit titles, slugs, dates, and URLs. The company_slug is obtainable from list_audited_companies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | The slug of the company, obtainable from list_audited_companies.companies[*].company_slug (e.g. 'ripple'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-halborn-com-api-ab2836a1/get_audits_by_company \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>"}'
```

### list_audited_companies

List audited companies with their slugs and detail URLs. Supports pagination, search by name, and sort ordering. Returns one page at a time; use the page parameter to advance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search query to filter companies by name. |
| `sort` | string | No | Sort order. Accepted values: 'newest', 'oldest'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-halborn-com-api-ab2836a1/list_audited_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<string>"}'
```

### list_blog_posts

List blog posts from Halborn with pagination and search support. Returns titles, slugs, dates, and URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search query to filter blog posts by title. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-halborn-com-api-ab2836a1/list_blog_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### list_reports

List whitepapers and security reports published by Halborn. Returns titles, types, dates, and URLs.

**Estimated cost:** Metered

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

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-halborn-com-api-ab2836a1/list_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```