# 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*

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intelligenceonchain.com/spectra-a-detective-in-your-browser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.