halborn.com APIhalborn.com ↗
Access Halborn's blockchain security audit reports, findings summaries, blog posts, and whitepapers via a structured API. Search by company, date, or keyword.
curl -X GET 'https://api.parse.bot/scraper/e787a22f-6c4c-416d-8787-31df1bdb0c63/list_audited_companies?page=1&sort=newest' \ -H 'X-API-Key: $PARSE_API_KEY'
List audited companies with their slugs and detail URLs. Supports pagination, search, and sort ordering.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: 'newest', 'oldest'. |
| query | string | Search query to filter companies by name. |
{
"type": "object",
"fields": {
"companies": "array of company objects each containing company_name, company_slug, and url"
},
"sample": {
"data": {
"companies": [
{
"url": "https://www.halborn.com/audits/ripple",
"company_name": "Ripple",
"company_slug": "ripple"
},
{
"url": "https://www.halborn.com/audits/chiliz",
"company_name": "Chiliz",
"company_slug": "chiliz"
}
]
},
"status": "success"
}
}About the halborn.com API
The Halborn API provides 5 endpoints for retrieving blockchain security audit data, research publications, and blog content from halborn.com. Use get_audit_detail to pull structured findings summaries — including critical, high, medium, and low severity counts alongside percentage_addressed — for any audited project. list_audited_companies lets you search and paginate the full roster of companies Halborn has assessed, while list_reports surfaces whitepapers and security research documents.
Audit Coverage
list_audited_companies returns an array of company objects, each with company_name, company_slug, and url. It accepts a query parameter for name-based filtering and a sort parameter (newest or oldest) to control ordering. The company_slug values feed directly into get_audits_by_company, which returns every audit Halborn has conducted for that company — each item includes audit_title, audit_slug, date, and url.
Audit Detail and Findings
get_audit_detail takes both a company_slug and an audit_slug and returns the most granular data available: an introduction narrative, date_of_engagement, last_updated, and a summary_stats object. That object breaks findings into total_findings, plus individual counts for critical, high, medium, low, and informational severity levels, along with percentage_addressed — useful for comparing remediation rates across projects.
Blog Posts and Reports
list_blog_posts returns paginated post records with title, slug, category, date, and url. The optional query parameter filters by keyword, making it practical for monitoring Halborn's coverage of specific protocols or vulnerability classes. list_reports pages through whitepapers and formal security reports, returning type, title, date, and url per item — helpful for tracking the publication of new research relevant to a particular ecosystem.
- Build a dashboard tracking open critical and high findings across all audited DeFi protocols using summary_stats severity counts.
- Monitor when a specific company receives a new audit by polling get_audits_by_company on a schedule.
- Compare percentage_addressed rates across projects to assess remediation thoroughness before integrating a third-party protocol.
- Aggregate Halborn blog posts by category to surface recent research on specific vulnerability classes.
- Compile a timeline of engagement dates across audits for a portfolio of crypto assets using date_of_engagement fields.
- Search list_audited_companies with a query parameter to check whether a protocol of interest has been assessed by Halborn.
- Index whitepapers from list_reports by publication date to stay current on Halborn's formal security research.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.