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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/halborn/`
**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 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/credits/halborn/get-audit-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/halborn/get-audits-by-company \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/halborn/list-audited-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/halborn/list-blog-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/halborn/list-reports \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

## Next steps

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