# Spectra - A Detective in your Browser

## User Guide

{% hint style="info" %}
**Privacy Commitment**

Spectra is committed to user privacy. **No user data or search results are stored besides emails used for creating a session**, ensuring that all searches remain secure and private. Token holders can use Spectra’s tools with confidence, knowing that their inquiries and any sensitive information remain entirely within their control.
{% endhint %}

### Overview

**Spectra** is a modular and continually expanding suite of tools that empowers token holders to conduct in-depth investigations directly within their browser. Designed for convenience and efficiency, Spectra’s modular architecture allows for easy addition of new, high-powered modules. As an added benefit, **IOC token holders can request features** to be built into Spectra, aligning its development with the community's evolving needs.

With the added peace of mind that **no data is stored on Spectra's servers**, users can confidently search and analyse sensitive information, knowing their privacy is preserved.

***

##

* ### 1. Introduction

  #### What is Spectra?

  Spectra is a powerful blockchain intelligence and OSINT (Open Source Intelligence) platform designed for cryptocurrency researchers, investigators, compliance professionals, and security analysts. The platform provides comprehensive tools for:

  * **Wallet Research** — Analyze cryptocurrency wallets across multiple blockchains
  * **Entity Identification** — Identify wallet owners using Arkham Intelligence data
  * **Risk Assessment** — Evaluate wallet risk levels based on labels and activity patterns
  * **Transaction Tracing** — Track funds through exchanges and mixers
  * **Web Intelligence** — Search across multiple engines for related information
  * **Social Media Monitoring** — Find mentions across social platforms

  #### Key Features

  | Feature             | Description                                          |
  | ------------------- | ---------------------------------------------------- |
  | Multi-chain Support | Ethereum, Bitcoin, Base, Arbitrum, Polygon, and more |
  | Arkham Integration  | Real-time entity identification and labeling         |
  | AI-Powered Analysis | GPT-powered summaries and risk assessments           |
  | Batch Processing    | Research up to 10 wallets simultaneously             |
  | Export Options      | Download results as CSV or JSON                      |
  | Real-time Data      | Live blockchain and web data                         |

### 2. Getting Started

#### System Requirements

Spectra works in any modern web browser:

* Google Chrome (recommended)
* Mozilla Firefox
* Microsoft Edge
* Safari

For MetaMask authentication:

* MetaMask browser extension installed
* Minimum 100 IOC tokens in your wallet

#### Accessing the Platform

1. Navigate to [**https://spectra.intelligenceonchain.com**](https://spectra.intelligenceonchain.com/)
2. Complete the human verification (Cloudflare Turnstile)
3. Choose your authentication method (Google or MetaMask)
4. Start using the platform tools

#### First-Time Setup

**Option A: Google Sign-In (Recommended for new users)**

1. Click the **"Sign In"** button in the top navigation
2. Click **"Continue with Google"**
3. Select your Google account
4. Choose a subscription plan to activate full features

**Option B: MetaMask Connection (For token holders)**

1. Ensure you have MetaMask installed
2. Ensure your wallet contains **100+ IOC tokens**
3. Click **"Connect Wallet"**
4. Sign the verification message in MetaMask
5. Full platform access is granted automatically

### 3. Authentication Methods

#### Google OAuth Authentication

Google authentication is the recommended method for most users. It provides:

* Easy sign-in with your existing Google account
* Subscription-based access to features
* Monthly API call tracking
* Secure session management

**How it works:**

1. Sign in with Google
2. Your account is created/linked automatically
3. Subscribe to a plan to unlock features
4. API calls are tracked against your monthly limit

#### MetaMask Authentication

MetaMask authentication is available for IOC token holders. It provides:

* **Unlimited access** to all platform features
* No monthly API call limits
* No subscription fees required
* Requires holding 100+ IOC tokens

**Requirements:**

* MetaMask browser extension
* Ethereum wallet with **≥100 IOC tokens**
* Token Contract: `0xeD1DdC491A2c8b1f7D6e8933580a47E124EA38db`

**How it works:**

1. Connect your MetaMask wallet
2. Sign a verification message (gas-free)
3. System verifies your IOC token balance
4. If balance ≥100 tokens, full access is granted

#### Session Management

* **Google sessions** expire after 24 hours
* **MetaMask sessions** persist until you disconnect
* Sessions are stored locally in your browser
* Clearing browser data will log you out

### 4. Subscription Plans

#### Plan Comparison

| Feature               | Free | Basic | Pro    | Enterprise | Token Holder |
| --------------------- | ---- | ----- | ------ | ---------- | ------------ |
| **Monthly Price**     | $0   | £8.99 | £14.99 | £29.99     | 100+ IOC     |
| **API Calls/Month**   | 0    | 30    | 75     | 400        | Unlimited    |
| **Deep Search**       | ✅    | ✅     | ✅      | ✅          | ✅            |
| **User Search**       | ❌    | ✅     | ✅      | ✅          | ✅            |
| **Crypto Bloodhound** | ❌    | ✅     | ✅      | ✅          | ✅            |
| **Keyword Extractor** | ❌    | ✅     | ✅      | ✅          | ✅            |
| **Email Extractor**   | ❌    | ✅     | ✅      | ✅          | ✅            |
| **Exchange X-Ray**    | ❌    | ✅     | ✅      | ✅          | ✅            |
| **Wallet Researcher** | ❌    | ✅     | ✅      | ✅          | ✅            |
| **Priority Support**  | ❌    | ❌     | ✅      | ✅          | ✅            |

#### Subscribing to a Plan

1. Sign in with Google
2. Click the **"Upgrade"** button or access a locked feature
3. Select your desired plan
4. Complete payment via Stripe (secure checkout)
5. Your account is activated immediately

#### Managing Your Subscription

* View remaining API calls in the top navigation bar
* Upgrade or downgrade anytime
* Cancel through your account settings
* API calls reset on the 1st of each month

#### Credit Usage

Different actions consume different amounts of credits:

| Action                     | Credit Cost                                  |
| -------------------------- | -------------------------------------------- |
| Domain/General Search      | 1 credit                                     |
| User Social Search         | 2 credits                                    |
| Wallet Search              | 2 credits                                    |
| Instant Exchange X-ray     | 5 credits                                    |
| Email extraction           | 3 credit                                     |
| Website basic OSInt        | 1 credit                                     |
| Multi-wallet Auto Research | <p>3 credits (basic)<br>5 credits (deep)</p> |

### 5. Platform Tools

#### Tool Overview

Spectra provides several specialized intelligence tools:

| Tool                  | Purpose                                 | Access Level |
| --------------------- | --------------------------------------- | ------------ |
| **Deep Search (Web)** | Search websites across multiple engines | Free         |
| **User Search**       | Find information about usernames        | Free         |
| **Crypto Bloodhound** | Search blockchain addresses with Arkham | Basic+       |
| **Keyword Extractor** | Extract keywords from websites          | Basic+       |
| **Email Extractor**   | Find emails associated with domains     | Pro+         |
| **Exchange X-Ray**    | Trace funds through exchanges           | Enterprise   |
| **Wallet Researcher** | Comprehensive wallet analysis           | Enterprise   |

#### Navigation

* Use the **left sidebar** to switch between tools
* Active tool is highlighted in green
* Locked tools show a lock icon (🔒)
* Click a locked tool to see upgrade options

### 6. Wallet Researcher

#### Overview

The Wallet Researcher is Spectra's most powerful tool, providing comprehensive analysis of cryptocurrency wallets including:

* Entity identification via Arkham Intelligence
* Risk assessment and scoring
* Token holdings and portfolio value
* Transaction patterns and history
* Web mentions and social media activity
* AI-powered analysis summaries

#### Using Wallet Researcher

**Step 1: Enter Wallet Address(es)**

1. Navigate to **Wallet Researcher** in the sidebar
2. Enter one or more wallet addresses in the text area
3. Supported formats:
   * Ethereum: `0x...` (42 characters)
   * Bitcoin Legacy: `1...` or `3...`
   * Bitcoin SegWit: `bc1...`
4. Separate multiple addresses with commas or new lines
5. Maximum: 10 addresses per batch

**Example:**

```
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503
bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
```

**Step 2: Configure Research Options**

| Option              | Description                       | Credit Cost |
| ------------------- | --------------------------------- | ----------- |
| **AI Analysis**     | Include GPT-powered summary       | Standard    |
| **Risk Assessment** | Calculate risk score and factors  | Standard    |
| **Token Holdings**  | Fetch ERC-20 token balances       | Standard    |
| **TX Analysis**     | Analyze transaction patterns      | Standard    |
| **Deep Search**     | Extended web search (15+ sources) | +2 credits  |

**Step 3: Run Research**

1. Click **"Research Wallets"**
2. Progress bar shows analysis status
3. Results appear when complete
4. Each wallet displays in a separate card

#### Understanding Results

**Identity Section**

* **Entity Name** — Known identity (e.g., "Binance", "Tornado Cash")
* **Entity Type** — Category (Exchange, DeFi, Individual, etc.)
* **ENS Name** — Ethereum Name Service domain if registered
* **Labels** — Tags applied by Arkham Intelligence

**Risk Assessment**

| Risk Level  | Score Range | Meaning                        |
| ----------- | ----------- | ------------------------------ |
| 🟢 Low      | 0-19        | No significant risk indicators |
| 🟡 Medium   | 20-39       | Some risk factors present      |
| 🔴 High     | 40-59       | Multiple risk indicators       |
| ⚠️ Critical | 60-100      | Sanctioned/high-risk entity    |

**Risk Factors Include:**

* Sanctioned entity labels (OFAC, etc.)
* Mixer/tumbler associations
* Hack/exploit connections
* Scam/fraud indicators
* Anonymous high-value activity

**Portfolio & Transactions**

* **Portfolio Value** — Total USD value of token holdings
* **Top Tokens** — Largest token positions
* **Transaction Count** — Total on-chain transactions
* **Patterns** — Detected activity patterns (automation, etc.)

**AI Analysis**

* GPT-3.5 powered summary
* Synthesizes all available data
* Provides professional intelligence assessment
* 100-120 word concise summary

#### Exporting Results

Click the export buttons to download your research:

* **Export CSV** — Spreadsheet format for Excel/Google Sheets
* **Export JSON** — Structured data for developers

### 7. Exchange X-Ray Tracer

#### Overview

Exchange X-Ray traces cryptocurrency through exchanges to identify withdrawal destinations. This is essential for:

* Following funds after exchange deposits
* De-mixing tumbler transactions
* Compliance investigations
* Fraud tracing

#### How Exchange Tracing Works

1. You provide a **deposit transaction** to an exchange
2. The tool finds the exchange's matching **withdrawal** within a time window
3. Results show potential destination wallets
4. Uses value and timing correlation

#### Using Exchange X-Ray

**Required Information**

| Field                | Description              | Example       |
| -------------------- | ------------------------ | ------------- |
| **Transaction Hash** | The deposit TX hash      | `0xabc123...` |
| **Deposit Address**  | Exchange deposit address | `0xdef456...` |
| **Date**             | Date of the deposit      | `2025-01-15`  |
| **Exchange**         | Target exchange name     | `changenow`   |

**Configuration Options**

| Parameter             | Default | Description                       |
| --------------------- | ------- | --------------------------------- |
| **Time Tolerance**    | 5 min   | Search window around deposit time |
| **Value Tolerance %** | 0.1     | Acceptable value difference (10%) |
| **Max Tolerance**     | $200    | Maximum USD difference allowed    |

**Supported Exchanges**

* ChangeNOW
* Binance
* Kraken
* Coinbase
* KuCoin
* And many more...

**Interpreting Results**

Results show potential matching withdrawals:

| Column               | Description                  |
| -------------------- | ---------------------------- |
| **To Address**       | Potential destination wallet |
| **Transaction Hash** | Withdrawal transaction       |
| **USD Value**        | Historical USD value at time |
| **Timestamp**        | When withdrawal occurred     |

⚠️ **Important:** Results highlighted in red have values **higher** than the deposit, making them unlikely matches (exchanges deduct fees).

#### Best Practices

1. **Start with narrow tolerances** — Expand if no results
2. **Verify the deposit TX** — Ensure it actually went to the exchange
3. **Check multiple results** — There may be several candidates
4. **Cross-reference** — Use Wallet Researcher on destination addresses

### 8. Deep Search Tools

#### Website Deep Search (Bloodhound Web)

Search for information about any website or domain across multiple search engines.

**How to Use:**

1. Enter a website URL or domain
2. Click **"Search"**
3. Results appear from Google and Brave simultaneously

**Advanced Buttons:**

| Button          | Function                                          |
| --------------- | ------------------------------------------------- |
| **x-S.Engines** | Opens 5+ search engines in new tabs               |
| **Files**       | Searches for documents (PDF, DOC, XLS, etc.)      |
| **Leaks**       | Searches paste sites and leak databases           |
| **Social**      | Opens social media platform searches              |
| **Archive**     | Searches Wayback Machine for historical snapshots |

#### Crypto Bloodhound

Search for cryptocurrency addresses with enhanced blockchain intelligence.

**Features:**

* Google & Brave search results
* Arkham Intelligence entity lookup
* Social media mention search
* AI-powered summary of findings

**Results Include:**

* Search engine results
* Arkham entity identification
* Multi-chain presence detection
* Social media mentions with AI summary

#### User Deep Search

Find information about usernames across the internet.

**How to Use:**

1. Enter a username (without @)
2. Click **"Search"**
3. Review results from multiple sources

**Advanced Buttons:**

| Button          | Function                             |
| --------------- | ------------------------------------ |
| **x-S.Engines** | Multi-engine username search         |
| **Dehashed**    | Check breach databases               |
| **Social**      | Search social platforms directly     |
| **Leaks**       | Search paste/leak sites              |
| **inText**      | Google intext: search                |
| **Files**       | Search for files mentioning username |

### 9. Email & Data Extraction

#### Email Extractor

Find email addresses associated with a domain.

**How to Use:**

1. Navigate to **Email Extractor**
2. Enter a domain (e.g., `example.com`)
3. Click **"Extract Emails"**
4. View results in table format

**Results Include:**

* Email addresses
* First/Last names (when available)
* Job positions/titles
* Department information

#### OSINT Data Extractor (Keyword Extractor)

Extract structured data from websites automatically.

**Data Types Extracted:**

* Person names
* Email addresses
* Phone numbers
* Physical addresses
* Organization names
* Social media profiles
* IP addresses
* Cryptocurrency addresses
* URLs

**How to Use:**

1. Navigate to **Keyword Extractor**
2. Enter a website URL
3. Click **"Extract Data"**
4. Review categorized results

### 10. Account Management

#### Viewing Your Account

Your account information appears in the top navigation:

* **Profile picture** — Your Google avatar or wallet identicon
* **Name** — Your display name
* **Tier badge** — Current subscription level
* **API calls remaining** — For Google auth users

#### Checking Credit Balance

For subscription users:

1. Look at the top navigation bar
2. **"Calls: X"** shows remaining monthly credits
3. Credits reset on the 1st of each month

#### Upgrading Your Plan

1. Click the **"Upgrade"** button
2. Select your new plan
3. Complete payment
4. New limits apply immediately
5. Unused credits do not roll over

#### Canceling Subscription

1. Access your Stripe customer portal
2. Click "Cancel subscription"
3. Access continues until period end
4. Revert to Free tier after cancellation

#### Disconnecting / Signing Out

**For Google users:**

* Click your profile picture
* Click **"Sign Out"**

**For MetaMask users:**

* Click the **"Disconnect"** button
* Or disconnect from MetaMask directly

### 11. Troubleshooting

#### Authentication Issues

**"Authentication failed" Error**

**Cause:** Session expired or invalid credentials

**Solutions:**

1. Sign out completely
2. Clear browser cache/cookies
3. Sign in again
4. If using MetaMask, verify token balance

**"Session expired" Message**

**Cause:** Google sessions last 24 hours

**Solution:** Simply sign in again with Google

**MetaMask Connection Fails**

**Possible causes:**

1. MetaMask not installed
2. Insufficient IOC token balance
3. Wrong network selected

**Solutions:**

1. Install MetaMask extension
2. Ensure ≥100 IOC tokens in wallet
3. Switch to Ethereum Mainnet

#### Credit & Subscription Issues

**"Monthly limit reached" Error**

**Cause:** You've used all API calls for the month

**Solutions:**

1. Wait until the 1st of next month
2. Upgrade to a higher tier
3. Connect MetaMask with 100+ IOC tokens

**Subscription Not Recognized**

**Cause:** Delay in payment processing

**Solutions:**

1. Wait 2-3 minutes after payment
2. Sign out and sign in again
3. Check email for Stripe confirmation
4. Contact support if issue persists

#### Tool-Specific Issues

**No Arkham Results**

**Cause:** Address not in Arkham's database

**Note:** Not all addresses are labeled. Unknown wallets show "Unknown Entity"

**Exchange Trace Returns No Results**

**Possible causes:**

1. Transaction not yet indexed
2. Time tolerance too narrow
3. Value tolerance too strict
4. Exchange not supported

**Solutions:**

1. Wait 10-15 minutes for new transactions
2. Increase time tolerance (try 15-30 min)
3. Increase value tolerance (try 1-5%)
4. Verify exchange name spelling

**Search Returns Empty**

**Possible causes:**

1. Query too specific
2. No public information exists
3. Rate limiting from search engines

**Solutions:**

1. Try broader search terms
2. Use advanced search buttons
3. Wait a few minutes and retry

#### Browser Issues

**Page Not Loading**

1. Check internet connection
2. Try a different browser
3. Disable browser extensions
4. Clear cache and cookies

**Features Not Working**

1. Enable JavaScript
2. Disable ad blockers
3. Allow pop-ups for advanced searches
4. Update your browser

### 12. FAQ

#### General Questions

**Q: Is Spectra free to use?** A: Basic search features are free. Advanced tools require a subscription or 100+ IOC tokens.

**Q: What blockchains are supported?** A: Ethereum, Bitcoin, Base, Arbitrum, Optimism, Polygon, Avalanche, BNB Chain, Solana, Tron, and more.

**Q: How accurate is the data?** A: Data comes from Arkham Intelligence, on-chain sources, and search engines. Entity labels are generally reliable but should be verified for critical decisions.

**Q: Is my search data private?** A: We don't store your search queries. Sessions are encrypted and data is processed in real-time.

#### Authentication Questions

**Q: Why use MetaMask over Google?** A: MetaMask provides unlimited access with no monthly limits if you hold 100+ IOC tokens.

**Q: Can I use both authentication methods?** A: Yes, but they are separate accounts. Choose one primary method.

**Q: What happens if my token balance drops below 100?** A: You'll lose access until balance is restored. Consider subscribing as backup.

#### Subscription Questions

**Q: When do credits reset?** A: On the 1st of each month at 00:00 UTC.

**Q: Do unused credits roll over?** A: No, credits reset monthly and don't accumulate.

**Q: Can I get a refund?** A: Contact support within 7 days of purchase for refund requests.

**Q: How do I cancel?** A: Through the Stripe customer portal linked in your account.

#### Technical Questions

**Q: What is the IOC token contract address?** A: `0xeD1DdC491A2c8b1f7D6e8933580a47E124EA38db` on Ethereum Mainnet

**Q: Why do deep searches cost more credits?** A: Deep searches query more sources and take longer to process.

**Q: Can I use the API directly?** A: API access is coming soon. Contact us for enterprise API needs.

### 13. Support & Contact

#### Getting Help

**Documentation:** You're reading it! 📖

**Email Support:** <support@intelligenceonchain.com>

**Response Times:**

* Free users: 48-72 hours
* Basic/Pro: 24-48 hours
* Enterprise: 4-12 hours
* Token holders: 24 hours

#### Reporting Issues

When reporting issues, please include:

1. Your authentication method (Google/MetaMask)
2. Browser and version
3. Steps to reproduce the issue
4. Any error messages (screenshots help)
5. Wallet address being researched (if applicable)

#### Feature Requests

We welcome feature suggestions! Email us with:

* Detailed description of the feature
* Use case / why it would be helpful
* Any examples from other tools

#### Community

* **Twitter/X:** [@IntelOnChain](https://x.com/IntelOnChain)
* **Website:** [intelligenceonchain.com](https://intelligenceonchain.com/)

### Appendix A: Keyboard Shortcuts

| Shortcut | Action                     |
| -------- | -------------------------- |
| `Enter`  | Submit current form/search |
| `Esc`    | Close modal dialogs        |
| `Tab`    | Navigate between fields    |

### Appendix B: Supported Address Formats

| Blockchain     | Format                   | Example                                      |
| -------------- | ------------------------ | -------------------------------------------- |
| Ethereum       | `0x` + 40 hex chars      | `0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045` |
| Bitcoin Legacy | `1` or `3` + 25-34 chars | `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa`         |
| Bitcoin SegWit | `bc1` + 39-59 chars      | `bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh` |

### Appendix C: Risk Level Definitions

#### 🟢 Low Risk (0-19)

* No negative labels
* Standard wallet activity
* Known entities (exchanges, DeFi protocols)

#### 🟡 Medium Risk (20-39)

* Minor risk indicators
* Unidentified wallet with high activity
* Indirect mixer connections

#### 🔴 High Risk (40-59)

* Multiple risk factors
* Direct mixer usage
* Scam/fraud associations
* Suspicious transaction patterns

#### ⚠️ Critical Risk (60-100)

* OFAC sanctioned entities
* Known hacker groups (Lazarus, etc.)
* Confirmed theft/exploit addresses
* Terrorist financing links

### Appendix D: Glossary

| Term              | Definition                                              |
| ----------------- | ------------------------------------------------------- |
| **Arkham**        | Blockchain intelligence company providing entity labels |
| **ENS**           | Ethereum Name Service - human-readable wallet names     |
| **HMAC**          | Hash-based Message Authentication Code                  |
| **IOC**           | Intelligence On Chain token                             |
| **KYC**           | Know Your Customer - identity verification              |
| **Mixer/Tumbler** | Service that obscures transaction trails                |
| **OFAC**          | Office of Foreign Assets Control (US sanctions)         |
| **OSINT**         | Open Source Intelligence                                |
| **Sanctioned**    | Blocked by government authorities                       |
| **SegWit**        | Segregated Witness - Bitcoin address format             |

**© 2025 Intelligence On Chain. All rights reserved.**

*This documentation is subject to change. Last updated: January 2025*

***