# bio.halowerk.com Allergen Epitope Similarity Analyzer

> bio.halowerk.com Allergen Epitope Similarity Analyzer is a paid API for AI agents from bio.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Builds amino-acid k-mer sets from a query protein sequence and known epitopes, computes Jaccard similarity, and finds the highest contiguous identity window between each epitope and the query sequence.

## Facts

- Endpoint: POST https://bio.halowerk.com/v1/allergen-epitope
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bio-halowerk-com-allergen-epitope-similarity-analyzer-8ee11ef9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xbNv9DaSsnp_gwBpLgyKr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bio-halowerk-com-allergen-epitope-similarity-analyzer-8ee11ef9 -d '<json body>'
```

Example prompt: Compare this protein sequence MKTIIALSYIFCLVFA...RNDEQK against these 5 known allergen epitopes — use a k-mer size of 6 — and tell me the Jaccard similarity and highest contiguous identity for each epitope.

## When to prefer this

Use this endpoint when you need a fast, computational sequence-similarity comparison between a query protein and a set of known epitopes using k-mer and contiguous identity methods. It is appropriate for bioinformatics screening workflows, research pipelines, or preliminary similarity assessments — not for clinical allergenicity prediction, immune binding affinity prediction, or as a replacement for curated allergen databases.

## Known failure modes

- Invalid amino acid characters in query_sequence or epitope sequences (must match ^[ACDEFGHIKLMNPQRSTVWY]+$)
- kmer_size outside allowed range of 2–12 returns validation error
- known_epitopes array empty or exceeds 200 items
- query_sequence or epitope sequence shorter than 2 characters
- Epitope sequence longer than 500 characters or query longer than 10000 characters
- Missing required fields (query_sequence or known_epitopes)

## How this service works

Builds amino-acid k-mer sets, calculates Jaccard similarity, and finds the highest contiguous identity between each supplied epitope and any equal-length window of the query. It does not predict immune binding, allergenicity, cross-reactivity or clinical risk and cannot replace curated databases or laboratory testing.

## Output

Returns per-epitope results including Jaccard similarity score (based on k-mer set overlap) and the highest contiguous identity found between the epitope and any equal-length window in the query sequence. Does not include immune binding predictions, allergenicity risk scores, or clinical assessments.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kmer_size": {
   "type": "integer",
   "maximum": 12,
   "minimum": 2
  },
  "known_epitopes": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "sequence"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     },
     "sequence": {
      "type": "string",
      "pattern": "^[ACDEFGHIKLMNPQRSTVWY]+$",
      "maxLength": 500,
      "minLength": 2
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200,
   "minItems": 1
  },
  "query_sequence": {
   "type": "string",
   "pattern": "^[ACDEFGHIKLMNPQRSTVWY]+$",
   "maxLength": 10000,
   "minLength": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bio-halowerk-com-allergen-epitope-similarity-analyzer-8ee11ef9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bio.halowerk.com](https://www.zero.xyz/host/bio.halowerk.com/llms.txt)
