# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
This site has an agentic ask interface you may use to query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bicscan.io/index.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

---

# Introduction

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FrLNyqqx0AAbQV4sETpSE%2FBI_negative.png?alt=media&amp;token=07580459-8d80-410b-a21d-3f0844bf7043" alt=""><figcaption></figcaption></figure>

BICScan is a service that scans blockchain wallets, contract addresses, and dApp URLs that could harm users to determine their risk level.

### What BICScan can look up

Users can look up the maliciousness and suspiciousness of the following items

* Wallet Address
* Contract address
* dApp address

### Networks supported by BICScan

The following networks are supported by BICScan and will be added gradually in the future.

* Ethereum
* Polygon
* Binance Smart Chain
* Klaytn
* Arbitrum
* Avalanche

BICScan is pronounced `/ˈbiɡ skæn/` and stands for `Blockchain Information Correlation Scanner`.

### Who created BICScan and why?

BICScan is developed by AhnLab Blockchain Company. With our vision; More Security, More Freedom, BICScan intends to provide safer environment for blockchain and its community.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FhojUV27HaQXdO8VC8ZIp%2FCI_block_abc_noBG_color_2lines.png?alt=media&amp;token=f2129910-164f-4564-95e9-56548610f0c1" alt="" width="375"><figcaption><p>AhnLab Blockchain Company</p></figcaption></figure>

If you want to know more about the AhnLab Blockchain Company, please go to: <https://ahnlabblockchain.company>


# Before using BICScan

BICScan, provided by AhnLab Blockchain Company, can be used via WebUI and API, and credits are deducted according to the number of uses.

This document covers the following for basic scanning.

* Installing and connecting your wallet
* How to generate an App Key
* How to perform a scan
* How to manage your account and quota
* Where to find API documentation

### 1. Installing ABC Wallet

ABC Wallet is a cryptocurrency wallet created by AhnLab Blockchain Company and can be downloaded below.

[Chrome WebStore](https://chrome.google.com/webstore/detail/abc-wallet/mlhakagmgkmonhdonhkpjeebfphligng) | [iOS AppStore](https://apps.apple.com/app/abc-wallet-safe-web3-wallet/id1642837445) | [Android Playstore](https://play.google.com/store/apps/details?id=io.myabcwallet.mpc\&hl=en\&gl=US)

For a detailed video guide to installing ABC Wallet, see below.

<figure><img src="https://img.youtube.com/vi/oL2KPu-DuLo/0.jpg" alt="" width="563"><figcaption></figcaption></figure>

### 2. Connect to BICScan

In a browser with ABC Wallet installed, type <https://bicscan.io> in the address bar to open BICScan website.

### 3. Login with ABC Wallet

After accessing the BICScan website, click the `Connect ABC Wallet` button in the upper right corner to connect with your wallet.

If you are using Browser Extension ABC Wallet, select `Browser ABC Wallet` at the bottom. Then the Browser ABC Wallet popup window will appear and you will be connected to BICScan after logging in.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FKHskpOnOva298ZiNuv9m%2F%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%202023-08-29%20221633.png?alt=media&amp;token=7b86160d-05d5-411a-b1c7-4417706fb31d" alt=""><figcaption></figcaption></figure>

In case of Mobile ABC Wallet, select `Mobile ABC Wallet` at the top. Then the QR Code like below will be generated.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FZpIJSgNjpKpSSrpWpLGY%2F%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%202023-08-29%20221804.png?alt=media&amp;token=50b50dd7-216b-4763-9fc2-fe90785d4387" alt="" width="386"><figcaption></figcaption></figure>

Open up ABC Wallet on your mobile phone and tap right top "QR Scan" icon (red box in the screenshot below) to scan the QR code above. Then you will be connected to BICScan.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FjAxAYSWzIfExVVQ9ewGA%2Fmobile_abc_wallet_red_box.png?alt=media&amp;token=d3d1cdcb-edc3-4588-8d03-1241a8565d6a" alt="" width="375"><figcaption></figcaption></figure>

After successful login, the wallet address will be displayed in the upper right corner of the Bicscan main screen with the network icon selected in the wallet.

### 4. Create BICScan App

In order to perform a scan, whether through the UI or API, an App Key must be created the first time. You can create multiple app keys. Queries executed on the UI will use the first created App key. However, quota allocation/deduction is calculated based on the wallet address, not per app key.

> **Warning**
>
> For security purposes, manage your App Key carefully to ensure that it does not fall into the wrong hands. To replace an App Key, you need to edit the App key and regenerate to a new one.

To create an App Key, please perform the following steps

#### 4.1. Go to Profile

You can view the list of apps you own by clicking on your wallet address in the top right corner and going to Profile in the menu.

You will be asked to sign to verify the wallet user you have connected. No worries, you will not be charged at this stage.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FNe9UQ7cqoDmSehyQogqL%2Fabcwallet_signing_en.png?alt=media&amp;token=a7c92bbd-60e2-4bcb-8f4a-a71dbc4c4c24" alt=""><figcaption></figcaption></figure>

#### 4.2. Creating an App

Click the user addresss in the top right corner, navigate to `Profile` in the menu. In the Profile page, click `Create App` button to create a new app.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FaifELUkIu6au6oAJ8FRY%2Fapplist_en.png?alt=media&amp;token=343cf348-15ce-4e7d-b6d0-c643c692f9a0" alt=""><figcaption></figcaption></figure>

#### 4.3. Enter an app name and description

Enter a name for the app being created. While app name and description can be edited later, we recommend using intuitive names like "AppName-Dev", "Application-Backend", and so on.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2Fh6zCh4QI83N7XPSJZdoN%2Fapp_name_desc_en.png?alt=media&amp;token=9f183fda-9b9c-4bd0-b7f4-bd50ddcdaa53" alt=""><figcaption></figcaption></figure>

#### 4.4. Sign to complete app creation

Finally, sign the app to complete its creation.

#### 4.5. Complete

After signing, the new app will be registered on the screen, and you can click on it for more information.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FUoOSl9Kbremmdbu1dczp%2F%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%202023-08-29%20222312.png?alt=media&amp;token=f1780b52-5ce7-44d7-b714-7f79b264fd90" alt=""><figcaption></figcaption></figure>

To see more information about the app, click [View App Details](/start-using-bicscan#app-list).

You can now use [Perform a new scan](/start-using-bicscan#perform-a-new-scan) in BICScan.


# Start using BICScan

### Perform a new scan

Click the BICScan title in the upper left corner or enter <https://bicscan.io> on your browser to go to the main page of BICScan.

> If your ABC Wallet is not connected yet, please click `Connect ABC Wallet` to complete the connection. Please refer to [Login with ABC Wallet](https://docs.bicscan.io/pages/jRV2uMZTfOYDD1t5fXxx#3.-login-with-abc-wallet) for how to connect.

Enter the dApp URL, Wallet address, or Contract address in the search bar and press `Enter` key to start scan.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FqkVar4dVZMXTNGreAK8R%2Fimage.png?alt=media&amp;token=ae171a93-b811-4486-8508-3e943f19dd7a" alt=""><figcaption><p>Type something and press [Enter]</p></figcaption></figure>

### What kind of search BICScan supports?

BICScan supports omnisearch in search query.

* Contract Address: smart contract address
* Wallet Address: externally owned account address
* ENS: Ethereum Name Service (eg. something.eth)
* CNS: Unstoppable Domains (eg.&#x20;

### Which Chain networks does BICScan Supports?

BICScan currently supports following blockchain networks:

* Ethereum
* Polygon
* Binance Smart Chain
* Klaytn
* Avalanche
* Arbitrum

### View Scan Results

Within a few seconds of performing the scan, you should be able to see a screen as following:

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FbPHU9qStyMagcIMfOWE9%2Fscan_result_en.png?alt=media&amp;token=4908a23a-758a-4172-adc1-4ca692b58432" alt=""><figcaption></figcaption></figure>

Here's a description of each element of the screen provided by the page.

* `Title`: Displays the hash or dapp URL.
* `Analysis Date`: Displays the date the report was generated. The date is in UTC.
* `Type`: Displays the type of the address. There are `address`, `contract`, and `domain`.
* `Category`: Category shows a consolidated view of how the value is categorized by the various engines.
* `Networks`: Displays the networks where the scan target exists. Clicking on a network will take you to the BlockExplorer for each chain.
* `Risk Score`: The score is displayed on a 100-point scale and shows the largest value across the detected sources. The closer the score is to 100, the higher the risk.
* `Vendors`: Different engines are used depending on what is detected, and displays the results detected by that engine.
* `Assets`: Displays balance of `token` in the address. Click to see the details of the token.

### Disconnect

Click `Wallet Address` > `Disconnect` to immediately disconnect from the wallet.


# Sharing your result

BICScan supports sharing reports, no more screenshot is required.

### How to share report

You can share the report once the scan is completed. Click the "Share" icon ![](https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2F3aWxGhdkA4rQ7aNtCRdy%2Fimage.png?alt=media\&token=2d887af3-9d26-4113-a56d-a8c1e073d720) to generate the share link on the fly. Once link is generated, OS's native sharing window will appear.

Copy and paste the link to anywhere.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FVj3bNr533pNzvFiR8EDk%2Fimage.png?alt=media&amp;token=4a0e4bb5-b90b-4f93-8ef4-98499506192c" alt="" width="347"><figcaption></figcaption></figure>

BICScan offers unlimited, no quota is charged for sharing reports.&#x20;

### Sharing button is disabled

While BICScan is performing the analysis, sharing is temporarly disabled. Once the completion, it will be available, so hold tight.&#x20;

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FQx8QEXoQXCKrFGqC9Rl7%2Fimage.png?alt=media&amp;token=ef6a6a8c-88be-458e-a843-5218cde6d04b" alt=""><figcaption></figcaption></figure>


# Browsing history

Sometimes you want to find address from your search history. Or simply you might want to find the difference now and then.&#x20;

You can always retrieve the result by "Profile" > "Your default app" > "Scan List".

Here you can click the item on the list to retrieve the result back.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FqEdK6jWQBNqQiCbMtsjr%2Fimage.png?alt=media&amp;token=cbcc49c7-dee0-44cb-92fa-eaace0364ca3" alt=""><figcaption></figcaption></figure>


# Profile

In Profile, you can see a list of apps you've created, the plan you're currently using, and how many queries you have left.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2F4JhD1aaQu5YHX0LEi5z9%2Fprofile_en.png?alt=media&amp;token=d741359c-d6a5-434d-b88c-741348209f72" alt=""><figcaption></figcaption></figure>

#### App List

You can manage your currently issued App Keys. You can create, delete, or rename new App and view detailed usage history.

**View App Details**

All queries performed in BICScan are managed on an app-by-app basis. You can revisit the search results or check the progress of a query that is taking a long time in the Scan List.

Below are descriptions of each element of the screen provided by the page.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FZNoPL9UOC1mbFf8udmZT%2Fappinfo_en.png?alt=media&amp;token=992624f0-91fa-43bf-8f43-46e4b298dd3d" alt=""><figcaption></figcaption></figure>

* **App Information**
  * `App Name`: The name of the app, as specified by the user.
  * `App Description`: The description of the app specified by the user.
  * `App Key`: The app's unique key issued by BICScan. Use it to access the API method.

    > **Warning**
    >
    > For security purposes, manage your App Key carefully to ensure that it does not fall into the wrong hands. To replace an App Key, you can regenerate the current key to a new one.
  * `Created At`: Displays the date the app was created.
  * `Edit`: Click the button to edit or **delete** the name and description.
* **Usage Graph**

  Graphs the number of times an App Key is used within the selected time period (`Day`, `Month`, `Year`).

  * `Day`: hourly, last 24 hours
  * `Month`: 1 day, last 30 days
  * `Year`: 1-month increments, last 12 months
* **Scan List**

  The app displays the list of results in chronological order. You can click an item to view the saved result report, which does not affect the scan quota.

  * `Query`: The item you requested to look up.
  * `Status`: Displays the current status. It is one of `done`, `scanning`.
  * `Type`: Displays the type of item, one of `domain`, `contract`, or `address`.
  * `Score`: Displays the score of the detected result. The closer the score is to 100, the higher the risk.
  * `Timestamp`: Shows the time in UTC.
  * `<`, `>`: Allows you to move forward or backward in the list.

#### Query Quota

Provides information about the queries assigned to the current user.

* `Allocated Quota`: Displays the total quota allocated to the user. It is reset every billing day.
* `Used Quota`: Displays the quota used in the current month. Includes the number of times the quota was scanned via the API or directly by the user via the Web UI. This does not include the number of times an existing history is viewed.
* `Remaining`: Displays the current remaining quota. You can scan as many times as that quota.

#### Billing Plan

Displays the plan that the user is currently using. Additionally, you can upgrade or downgrade.


# Pricing

BICScan prodivdes 1,000 requests/month for free. The free plan has a request limit of about 5-6 requests per minute. Please refer to the table below for the paid plan.

### Quota and QPS on each Plan

<table><thead><tr><th width="151" align="center">Payment Plan</th><th width="138" align="right">Monthly </th><th width="140" align="right">Yearly </th><th width="130" align="right">Query/sec.</th><th align="right">Avail. query/month</th></tr></thead><tbody><tr><td align="center">Free</td><td align="right">$0</td><td align="right">$0</td><td align="right">0.1</td><td align="right">1,000</td></tr><tr><td align="center">Basic</td><td align="right">$150</td><td align="right">$1,500</td><td align="right">1</td><td align="right">100</td></tr><tr><td align="center">Professional</td><td align="right">$379</td><td align="right">$3,790</td><td align="right">10</td><td align="right">300</td></tr><tr><td align="center">Team</td><td align="right">$1,799</td><td align="right">$17,990</td><td align="right">10</td><td align="right">2,000</td></tr></tbody></table>

If you need more quota, please contact us (<help@bicscan.io>) using the method below and we will get back to you.

To see detailed list for each plan, please go to [Free vs Paid plan](/faq/free-vs-paid-plan)


# FAQ

Frequently Asked Questions. Please choose item on the left menu.


# How do I change my App Key?

Head to [Profile](https://bicscan.io/profile) and select the App item that contains the App Key you want to change, then click the `Edit` button. Click the `Refresh` icon at the bottom (red box in the screenshot below)

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FDmPFSOH54F6EO8ecczRf%2Fimage.png?alt=media&amp;token=cdbbd680-1f6c-44bf-8b8c-690d299cd5dc" alt=""><figcaption></figcaption></figure>

After reading carefully to make sure you understand the consequences, click `Regenerate` to regenerate the App Key.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2FxfZMocx7t5UZrparMZiK%2Fimage.png?alt=media&amp;token=ad79149b-6817-4b22-b127-77fc0f9e86bf" alt=""><figcaption></figcaption></figure>

Once the App Key is regenerated, the old key will expire immediately and can no longer be used.


# Maximum query per second exceeded

### I get `Maximum query per second exceeded.` error message and the Scan request is not processed.

Free plan has a request limit of about 5-6 requests per minute. If you exceed the limit, you will not be able to make a request for the next 10 seconds. Please wait a moment and try again.

### I've maxed out my current plan usage, what should I do?

If you're a free user, your usage will reset first day of every month. If you're a paid user, your query will consume "Free plan" until next payment day. Note that free plan has limited functionality and provided data. In case even Free plan quota is used up, you cannot call API for scan anymore.

<figure><img src="https://2838226372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJP555F4bCSja911juZGT%2Fuploads%2Ficd3xGX41KsS5lt1FcWz%2Fimage.png?alt=media&amp;token=7c552980-074c-45a6-8540-0262d696e666" alt=""><figcaption></figcaption></figure>

### If I used all my quota, can I call other APIs?

Yes, your quota only limits `POST /v1/scan` and other API call is unaffected. You can retrieve previous scan result anytime.


# Free vs Paid plan

### What is the difference between paid and free plans?

Paid plans can be requested more frequently than free plans. The `Basic` and `Professional` plan allows request scan once a second, while the and `Team` plan allows to scan 10 times per second. You can also see `Premium` results (Uppsala, Coinfirm) on the results screen.

#### Price and quota availability

<table><thead><tr><th width="126">Category</th><th width="177">Free</th><th width="221">Paid Montly</th><th>Paid Yearly</th></tr></thead><tbody><tr><td>Price</td><td>Free</td><td><ul><li>Basic: $150/mo.</li><li>Pro.: $379/mo.</li><li>Team: $1,799/mo.</li></ul></td><td><ul><li>Basic: $1,500/yr.</li><li>Pro.: $3,790/yr.</li><li>Team: $17,990/yr.</li></ul></td></tr><tr><td>Available Quota</td><td>Only 1,000 query every month</td><td><ul><li>Basic: 100 queries</li><li>Pro.: 300 queries</li><li>Team: 2,000 queries</li></ul></td><td><ul><li>Basic: 1,200 queries</li><li>Pro.: 3,600 queries</li><li>Team: 24,000 queries</li></ul></td></tr><tr><td>Query per seconds (qps)</td><td>1 query per 10 seconds.</td><td><ul><li>Basic: 1 qps</li><li>Pro.: 1 qps</li><li>Team: 10 qps</li></ul></td><td><ul><li>Basic: 1 qps</li><li>Pro.: 1 qps</li><li>Team: 10 qps</li></ul></td></tr></tbody></table>

#### Scanners availability

<table><thead><tr><th width="127.33333333333331">Category</th><th width="207">Free</th><th>Paid Monthly and Yearly</th></tr></thead><tbody><tr><td>Wallet Address Scanners</td><td><ul><li>OFAC Sanction List</li><li>CryptoScamDB</li><li>ScamSniffer</li></ul></td><td><p>Everything incl. on Free plan and </p><ul><li>UppsalaSecurity</li><li>Coinfirm</li></ul></td></tr><tr><td>Contract Address Scanners</td><td><ul><li>OFAC Sanction List</li><li>CryptoScamDB</li><li>ScamSniffer</li><li>Coingecko</li></ul></td><td><p></p><p>Everything incl. on Free plan and </p><ul><li>UppsalaSecurity</li><li>Coinfirm</li></ul></td></tr><tr><td>URL Scanners</td><td><ul><li>OFAC Sanction List</li><li>409H</li><li>MetaMask Blacklist</li><li>CryptoScamDB</li><li>ScamSniffer</li><li>AhnLab V3</li></ul></td><td><p></p><p>Everything incl. on Free plan and </p><ul><li>UppsalaSecurity</li></ul></td></tr></tbody></table>

### What is the difference between Yearly and Monthly plan?

There are two major differences;

1. You get discount for paying up-front depending your choice of plan.
2. Your quota available between your payment due; that is if you have subscribed yearly plan, your quota is limited between day zero you've had the payment, until next year, your next payment day. In other words, you can use up all the given quota at first month.&#x20;


# Plan Expiration

### When does my paid plan expire?

You can find it in the `Query Quota` list on the [Profile](https://bicscan.io/profile) screen. The date value in the `Renewed At` column is the expiration date. On that date, your paid plan will expire/renew, and for free plans, your usage will be reset on that date.


# Contact & Partnerships

BICScan is developed by AhnLab Blockchain Company. For partnerships and inquiries, please send `help@bicscan.io` and we will respond as soon as possible.