# Fast Hash API
> Non-cryptographic hash functions — the fast hashes used in hash tables, bloom filters, sharding, deduplication and cache keys. Give it text (UTF-8) or raw bytes as hex and it returns the digest under every algorithm at once, or under one named algorithm: FNV-1 and FNV-1a (32- and 64-bit), djb2, sdbm, Jenkins one-at-a-time, CRC-16 (CCITT-FALSE and ARC/IBM), Fletcher-16 and Fletcher-32, and MurmurHash3 (x86 32-bit, with an optional seed). Each digest is returned in hex and as an unsigned integer. Everything is computed locally and deterministically, so the same input always maps to the same hash — exactly what you need for stable bucketing and lookups. These are deliberately NOT for security: they are fast and well-distributed, not collision-resistant. Ideal for hash-table and bloom-filter implementations, consistent sharding and partitioning, cache and dedup keys, A/B bucketing, and teaching how hashing works. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. For cryptographic hashes (SHA, MD5, HMAC) use a hash API, and for CRC-32/Adler-32 integrity checksums use a checksum API.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fasthash-api/..."
```

## Pricing
- **Free** (Free) — 6,135 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 15,650 calls/Mo, 8 req/s
- **Pro** ($28/Mo) — 207,500 calls/Mo, 20 req/s
- **Mega** ($66/Mo) — 1,080,000 calls/Mo, 50 req/s

## Endpoints

### Hash

#### `GET /v1/algorithm` — Hash with one algorithm

**Parameters:**
- `algorithm` (query, required, string) — e.g. fnv1a_32, murmur3_32, crc16_ccitt Example: `crc16_ccitt`
- `text` (query, optional, string) — Text Example: `123456789`
- `hex` (query, optional, string) — Or hex
- `seed` (query, optional, string) — Seed for murmur3 Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fasthash-api/v1/algorithm?algorithm=crc16_ccitt&text=123456789&seed=0"
```

**Response:**
```json
{
    "data": {
        "hex": "29b1",
        "bits": 16,
        "uint": 10673,
        "algorithm": "crc16_ccitt",
        "input_bytes": 9
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:14.612Z",
        "request_id": "c3e47f0c-26b8-4da3-8c61-eb1096bfd948"
    },
    "status": "ok",
    "message": "Hash (one algorithm)",
    "success": true
}
```

#### `GET /v1/hash` — Hash with every algorithm

**Parameters:**
- `text` (query, optional, string) — Text to hash (UTF-8) Example: `foobar`
- `hex` (query, optional, string) — Or raw bytes as hex
- `seed` (query, optional, string) — Seed for murmur3 (default 0) Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fasthash-api/v1/hash?text=foobar&seed=0"
```

**Response:**
```json
{
    "data": {
        "hashes": {
            "djb2": {
                "hex": "fde460be",
                "uint": 4259602622
            },
            "sdbm": {
                "hex": "a6437b0d",
                "uint": 2789440269
            },
            "fnv1_32": {
                "hex": "31f0b262",
                "uint": 837857890
            },
            "fnv1_64": {
                "hex": "340d8765a4dda9c2",
                "uint": "3750802935296928194"
            },
            "fnv1a_32": {
                "hex": "bf9cf968",
                "uint": 3214735720
            },
            "fnv1a_64": {
                "hex": "85944171f73967e8",
                "uint": "9625390261332436968"
            },
            "crc16_arc": {
                "hex": "b0c8",
                "uint": 45256
            },
            "fletcher16": {
                "hex": "ad7b",
                "uint": 44411
            },
            "fletcher32": {
                "hex": "85734437",
                "uint": 2238923831
            },
            "murmur3_32": {
                "hex": "a4c4d4bd",
                "seed": 0,
                "uint": 2764362941
            },
            "crc16_ccitt": {
                "hex": "be35",
                "uint": 48693
            },
            "jenkins_oat": {
                "hex": "f952fde7",
                "uint": 4182965735
            }
        },
        "input_bytes": 6,
        "seed_for_murmur3": 0
    },
    "meta": {
     
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fasthash-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "name": "Fast Hash API",
        "notes": "Non-cryptographic — do not use for passwords, signatures or integrity against tampering. MurmurHash3 is x86_32. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/hash",
                "params": {
                    "hex": "or raw bytes as hex",
                    "seed": "seed for murmur3 (default 0)",
                    "text": "text to hash (UTF-8)"
                },
                "returns": "every algorithm's digest"
            },
            {
                "path": "/v1/algorithm",
                "params": {
                    "seed": "for murmur3",
                    "text": "or hex",
                    "algorithm": "one of the listed names"
                },
                "returns": "that one algorithm's digest"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "algorithms": [
            "fnv1_32",
            "fnv1a_32",
            "fnv1_64",
            "fnv1a_64",
            "djb2",
            "sdbm",
            "jenkins_oat",
            "crc16_ccitt",
            "crc16_arc",
            "fletcher16",
            "fletcher32",
            "murmur3_32"
        ],
        "description": "Non-cryptographic hash functions — the fast hashes used in hash tables, bloom filters, sharding, deduplication
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/fasthash-api
OpenAPI spec: https://www.oanor.com/api/fasthash-api/openapi.json
