# BitFusion.IN - Full LLM & AI Agent Documentation

Welcome to BitFusion.IN. This document provides complete technical specifications for Large Language Models (LLMs) and autonomous AI agents (such as OpenAI ChatGPT, Anthropic Claude, Google Gemini, Perplexity, LangChain, AutoGen, and Cursor) to discover, understand, and programmatically invoke all 104+ online tools.

---

## 1. Automated Access & Policy
- **Robots Policy**: Explicitly allows all AI user-agents (`GPTBot`, `ClaudeBot`, `PerplexityBot`, `Google-Extended`, `Meta-ExternalAgent`, `Amazonbot`, `Bytespider`, `cohere-ai`, `OAI-SearchBot`, etc.).
- **Authentication**: All public APIs and tools require **zero authentication, zero API keys, and zero headers**.
- **CORS**: All API endpoints return `Access-Control-Allow-Origin: *` to allow seamless client-side and browser fetch calls.
- **Content-Type**: Standard `application/json` for API requests and responses.

---

## 2. API Endpoints

### 2.1 Tool Catalog Endpoint
- **URL**: `GET https://bitfusion.in/api/v1/tools`
- **Description**: Returns the full catalog of all 104+ tools with their category, metadata, URL, and execution capabilities.

### 2.2 Unified AI Tool Execution Gateway
- **URL**: `POST https://bitfusion.in/api/v1/tools` or `POST https://bitfusion.in/api/v1/execute`
- **Request Format**: JSON body with `action` (or `tool`) and input parameters.

```json
{
  "action": "dns-lookup",
  "host": "google.com",
  "types": ["A", "AAAA", "MX"]
}
```

- **Response Format**:
```json
{
  "ok": true,
  "action": "dns-lookup",
  "result": { ... },
  "timestamp": "2026-09-02T18:38:00Z"
}
```

---

## 3. Supported Tool Actions & Parameters

### 3.1 Network & DNS Tools

#### `dns-lookup`
- **Parameters**:
  - `host` (string, required): Domain name or IPv4 address.
  - `types` (array of strings, optional): `["A", "AAAA", "CNAME", "MX", "NS", "TXT", "SOA", "PTR"]` (defaults to all standard).
- **Example Payload**:
  `{"action": "dns-lookup", "host": "github.com", "types": ["A", "MX"]}`

#### `reverse-dns`
- **Parameters**:
  - `ip` (string, required): Valid IPv4 or IPv6 address.
- **Example Payload**:
  `{"action": "reverse-dns", "ip": "8.8.8.8"}`

#### `ip-lookup`
- **Parameters**:
  - `ip` (string, optional): Target IP address (if omitted, looks up the caller's IP).
- **Example Payload**:
  `{"action": "ip-lookup", "ip": "1.1.1.1"}`

#### `ssl-certificate-checker`
- **Parameters**:
  - `host` (string, required): Target hostname (e.g. `bitfusion.in`).
  - `port` (integer, optional): Default `443`.
- **Example Payload**:
  `{"action": "ssl-certificate-checker", "host": "wikipedia.org", "port": 443}`

#### `http-header-analyzer`
- **Parameters**:
  - `url` (string, required): HTTP or HTTPS URL to analyze.
- **Example Payload**:
  `{"action": "http-header-analyzer", "url": "https://bitfusion.in"}`

#### `asn-lookup`
- **Parameters**:
  - `query` (string, required): ASN (e.g. `AS15169`), IPv4 address, or CIDR prefix.
- **Example Payload**:
  `{"action": "asn-lookup", "query": "AS13335"}`

#### `mac-oui-lookup`
- **Parameters**:
  - `mac` (string, required): MAC address or OUI prefix (e.g. `00:1A:2B` or `00:1A:2B:3C:4D:5E`).
- **Example Payload**:
  `{"action": "mac-oui-lookup", "mac": "00:1A:2B:3C:4D:5E"}`

#### `tcp-port-checker`
- **Parameters**:
  - `host` (string, required): Target hostname or IP.
  - `ports` (array of integers, optional): `[80, 443, 22, 21, 25, 3306, 5432, 8080]`.
- **Example Payload**:
  `{"action": "tcp-port-checker", "host": "example.com", "ports": [80, 443]}`

---

### 3.2 Calculators & Math Tools

#### `percentage`
- **Parameters**:
  - `type` (string, required): `"what_is_percent"` | `"is_what_percent"` | `"percent_change"`
  - `val1` (number, required): First value (e.g. percent or initial value).
  - `val2` (number, required): Second value (e.g. total or new value).
- **Example Payload**:
  `{"action": "percentage", "type": "what_is_percent", "val1": 15, "val2": 250}` -> Result: `37.5`

#### `bmi-calculator`
- **Parameters**:
  - `weight` (number, required): Weight in kilograms.
  - `height` (number, required): Height in centimeters.
- **Example Payload**:
  `{"action": "bmi-calculator", "weight": 70, "height": 175}` -> Result: BMI `22.86`, Category `Normal weight`

#### `date-calculator`
- **Parameters**:
  - `startDate` (string, required): `YYYY-MM-DD`
  - `endDate` (string, required): `YYYY-MM-DD`
- **Example Payload**:
  `{"action": "date-calculator", "startDate": "2026-01-01", "endDate": "2026-09-02"}` -> Result: `244` days

#### `loan-calculator` / `mortgage-calculator`
- **Parameters**:
  - `amount` (number, required): Principal loan amount.
  - `rate` (number, required): Annual interest rate in percent.
  - `years` (number, required): Loan term in years.
- **Example Payload**:
  `{"action": "loan-calculator", "amount": 100000, "rate": 6.5, "years": 15}`

#### `subnet-calculator`
- **Parameters**:
  - `ip` (string, required): IPv4 address (e.g. `192.168.1.1`).
  - `cidr` (integer, required): Subnet mask prefix (e.g. `24`).
- **Example Payload**:
  `{"action": "subnet-calculator", "ip": "10.0.0.1", "cidr": 24}`

#### `prime-checker`
- **Parameters**:
  - `number` (integer, required): Number to check.
- **Example Payload**:
  `{"action": "prime-checker", "number": 9973}`

#### `fibonacci-generator`
- **Parameters**:
  - `n` (integer, required): Number of terms (max 100).
- **Example Payload**:
  `{"action": "fibonacci-generator", "n": 10}`

---

### 3.3 Converters

#### `base-converter`
- **Parameters**:
  - `value` (string, required): Input string number.
  - `fromBase` (integer, required): `2` | `8` | `10` | `16`
  - `toBase` (integer, required): `2` | `8` | `10` | `16`
- **Example Payload**:
  `{"action": "base-converter", "value": "255", "fromBase": 10, "toBase": 16}` -> Result: `"FF"`

#### `roman-numeral`
- **Parameters**:
  - `value` (string or integer, required): Roman string (e.g. `MMXXVI`) or Arabic integer (e.g. `2026`).
- **Example Payload**:
  `{"action": "roman-numeral", "value": 2026}` -> Result: `"MMXXVI"`

#### `unit-converter`
- **Parameters**:
  - `type` (string, required): `"length"` | `"weight"` | `"temperature"` | `"speed"` | `"digital"` | `"area"` | `"volume"`
  - `value` (number, required): Magnitude.
  - `from` (string, required): Source unit (e.g. `"km"`, `"miles"`, `"kg"`, `"lbs"`, `"celsius"`, `"fahrenheit"`, `"gb"`, `"mb"`).
  - `to` (string, required): Target unit.
- **Example Payload**:
  `{"action": "unit-converter", "type": "length", "value": 100, "from": "km", "to": "miles"}`

#### `base64`
- **Parameters**:
  - `mode` (string, required): `"encode"` | `"decode"`
  - `text` (string, required): Text payload.
- **Example Payload**:
  `{"action": "base64", "mode": "encode", "text": "Hello AI"}`

#### `url-encoder`
- **Parameters**:
  - `mode` (string, required): `"encode"` | `"decode"`
  - `text` (string, required): URL or component.
- **Example Payload**:
  `{"action": "url-encoder", "mode": "encode", "text": "https://bitfusion.in/search?q=AI tools"}`

---

### 3.4 Cryptography & Security

#### `hash-generator`
- **Parameters**:
  - `text` (string, required): Input text.
  - `algorithm` (string, optional): `"md5"` | `"sha1"` | `"sha256"` | `"sha512"` | `"all"` (default)
- **Example Payload**:
  `{"action": "hash-generator", "text": "BitFusion2026", "algorithm": "sha256"}`

#### `bcrypt-hash`
- **Parameters**:
  - `password` (string, required): Plaintext password.
  - `cost` (integer, optional): Cost factor (default 10).
- **Example Payload**:
  `{"action": "bcrypt-hash", "password": "SecurePassword123"}`

#### `crypto-random`
- **Parameters**:
  - `type` (string, optional): `"hex"` | `"base64"` | `"uuid"` | `"alphanumeric"`
  - `length` (integer, optional): Number of bytes or characters (default 32).
- **Example Payload**:
  `{"action": "crypto-random", "type": "hex", "length": 32}`

#### `password-generator`
- **Parameters**:
  - `length` (integer, optional): Password length (default 16, min 8, max 64).
  - `uppercase` (boolean, optional): Include A-Z.
  - `numbers` (boolean, optional): Include 0-9.
  - `symbols` (boolean, optional): Include special chars (!@#$%).
- **Example Payload**:
  `{"action": "password-generator", "length": 20, "symbols": true}`

---

### 3.5 Text Tools

#### `word-counter`
- **Parameters**:
  - `text` (string, required): Input text to analyze.
- **Returns**: Word count, character count (with/without spaces), line count, sentence count, reading time in minutes.
- **Example Payload**:
  `{"action": "word-counter", "text": "The quick brown fox jumps over the lazy dog."}`

#### `case-converter`
- **Parameters**:
  - `text` (string, required): Input text.
  - `type` (string, required): `"upper"` | `"lower"` | `"title"` | `"camel"` | `"snake"` | `"kebab"`
- **Example Payload**:
  `{"action": "case-converter", "text": "hello world from ai", "type": "title"}`

---

### 3.6 Trading & Derivatives

#### `position-sizing`
- **Parameters**:
  - `capital` (number, required): Total account capital.
  - `riskPercent` (number, required): Risk per trade percentage (e.g. 1.5).
  - `entryPrice` (number, required): Asset entry price.
  - `stopLoss` (number, required): Stop loss price.
- **Example Payload**:
  `{"action": "position-sizing", "capital": 50000, "riskPercent": 2, "entryPrice": 100, "stopLoss": 95}`

#### `black-scholes`
- **Parameters**:
  - `stockPrice` (number, required): Current underlying price ($S$).
  - `strikePrice` (number, required): Strike price ($K$).
  - `timeToExpiry` (number, required): Time to expiration in years ($T$).
  - `volatility` (number, required): Annualized volatility in percent (e.g. 25).
  - `riskFreeRate` (number, required): Risk-free interest rate in percent (e.g. 5).
- **Returns**: Call Price, Put Price, Call Delta, Put Delta, Gamma, Theta, Vega, Rho.
- **Example Payload**:
  `{"action": "black-scholes", "stockPrice": 100, "strikePrice": 100, "timeToExpiry": 0.5, "volatility": 20, "riskFreeRate": 5}`

---

## 4. Complete List of All 104 BitFusion Tools

1. **Converters**: `unit-converter`, `currency-converter`, `base-converter`, `roman-numeral`, `number-to-text`, `json-csv`, `base64`, `url-encoder`, `color-converter`
2. **Calculators**: `percentage`, `date-calculator`, `bmi-calculator`, `loan-calculator`, `mortgage-calculator`, `roi-calculator`, `tip-calculator`, `ip-calculator`, `subnet-calculator`, `prime-checker`, `fibonacci-generator`, `big-number-calc`
3. **Developer**: `json-formatter`, `html-encoder`, `regex-tester`, `code-minifier`, `code-beautifier`, `sql-formatter`, `jwt-decoder`, `code-comparison`, `dns-lookup`, `reverse-dns`, `http-header-analyzer`, `ssl-certificate-checker`, `tcp-port-checker`, `traceroute`, `dns-propagation-checker`, `asn-lookup`, `mac-oui-lookup`, `ping-test`, `ping-client`, `benchmark`
4. **Cryptography**: `hash-generator`, `bcrypt-hash`, `crypto-random`, `hmac-generator`, `pbkdf2-generator`, `aes-encryption`, `rsa-generator`, `digital-signature`
5. **Text Tools**: `word-counter`, `case-converter`, `lorem-generator`, `text-diff`, `duplicate-remover`, `find-replace`, `markdown-preview`, `upside-down-text`, `fancy-text`, `zalgo-text`
6. **Generators**: `password-generator`, `qr-generator`, `barcode-generator`, `random-number`, `uuid-generator`, `fake-data-generator`, `meme-generator`, `email-signature`, `bio-link`
7. **Image Tools**: `image-compressor`, `image-resizer`, `image-cropper`, `image-converter`, `image-effects`, `color-picker`, `pixel-art`, `image-to-base64`, `image-to-ico`, `gif-maker`, `photo-collage`, `watermark-adder`
8. **PDF Tools**: `pdf-merger`, `pdf-splitter`, `pdf-to-images`, `images-to-pdf`, `compress-pdf`, `rotate-pdf`
9. **Utilities**: `stopwatch`, `countdown-timer`, `timezone-converter`, `ip-lookup`, `whois-lookup`, `morse-code`, `typing-speed`
10. **Design & Media**: `svg-to-png`, `favicon-generator`, `placeholder-image`, `ascii-art`, `color-palette`
11. **Trading & F&O**: `position-sizing`, `futures-fair-value`, `theta-visualizer`, `option-payoff`, `black-scholes`, `iv-solver`