# Vision API (Beta)

#### Introduction

Welcome to the Vision API documentation. The Vision API is designed to provide real-time access to comprehensive blockchain data as soon as a contract is verified. Our API delivers unique social metrics, including the number of tweets, followers, account age on various social media platforms, website age, IP addresses, Scam and more. By integrating with the Vision API, developers can leverage these rich datasets to enhance their applications and services with the latest and most accurate information available.

#### How the Vision API Works

**API Endpoint**

The Vision API endpoint is:

```url
https://vision-scanner.com/api/api.php
```

**Request Parameters**

To access the API, you need to include the following parameters in your GET request:

* `key`: Your API key (mandatory)
* `ca`: The Ethereum contract address (mandatory)
* `base`: Specify the data layer (`1` for Base or `0` for Eth) (optional)

Example request URL:

```url
https://vision-scanner.com/api/api.php?key=YOUR_API_KEY&ca=0x739fc939f8ef2b69b8fc3e5914169d621cabdc1f&base=1
```

**Response Format**

The API responds with JSON-formatted data. The response includes either a success message with data or an error message. Here is the structure:

* On success:

  ```json
  {
      "success": 1,
      "message": "Success",
      "data": [
          {
              "time": "2023-06-10 12:00:00",
              "contract_name1": "Example Contract",
              "contract_name2": "Example Contract Secondary Name",
              "contract_bin": "0x...",
              "contract_address": "0x739fc939f8ef2b69b8fc3e5914169d621cabdc1f",
              "contract_antibot": "Yes",
              "contract_changefee": "No",
              "owner": "0x...",
              "owner_age": "2 years",
              "owner_fund_ens": "example.eth",
              "website": "https://example.com",
              "website_ip": "192.168.1.1",
              "website_age": "1 year",
              "tg": "@example",
              "tg_abo": "1000",
              "twitter": "@example",
              "twitter_abo": "2000",
              "twitter_age": "3 years",
              "twitter_tweet": "500",
              "scam": "No"
          }
      ]
  }
  ```
* On error:

  ```json
  {
      "error": 1,
      "errormessage": "Description of the error"
  }
  ```

#### Attribution Requirement

If you display results from our API on your platform, you must tag Vision by linking to our website <https://vision-scanner.com> or our Telegram channel <https://t.me/VisionPublic>. Proper attribution helps spread the word about our service and supports the community.

#### Free API Access

Currently, the Vision API is free to use. To obtain an API key, you need to request it from VisionAdmin on the Vision Telegram channel [VisionPublic](https://t.me/VisionPublic). We recommend reaching out early to secure your access and start integrating our data into your applications.

#### Upcoming Features

We are continuously improving our services. Soon, we will introduce a backtest feature that allows users to test and validate their strategies with historical data. Stay tuned for updates and new capabilities!

By following these guidelines and utilizing our API, you can ensure that you are getting the most out of the rich data sets provided by Vision. We look forward to seeing the innovative ways you integrate our data into your projects.


---

# 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://vision-8.gitbook.io/docs/different-bots/vision-api-beta.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.