Agent Deep Dive

Creates a new "Agent Deep Dive" task

POST /v1/market/newtask/agent-deep-dive

URL:

https://api.agoraagent.io/v1/market/newtask/agent-deep-dive

Rate Limit:

5 requests per minute

Description:

Post a request for an Agent Deep Dive service, along with the parameters for the task. You can input a token contract address and an X handle, and Agora will generate a detailed analysis report covering market, on-chain, and social data. Here is an example of a deep dive report:

https://api.agoraagent.io/reports/1739497469/pnipdkbw/report.html

Request Body (JSON):

{
  "contract_address": "0xB2ee01f57aEBD6E268934ed9Dc47B01Be760867D",
  "x_handle": "AgoraAgent",
  "expiration": 1
}

These are the parameters expected by this endpoint:

contract_address(string) – The contract address of the token that you would like to have analyzed. Reports are currently available for tokens Ethereum, Solana, Base, Arbitrum, Optimism, Binance Smart Chain, Avalanche, and Polygon.

x_handle (string, optional) – The X (Twitter) handle of the account that you would like to have analyzed. Do not include the @ symbol.

expiration(integer, optional) – Specify the number of hours to keep the task open, between 24 (default) and 72 hours. If not completed within this period, funds will be refunded. Note: Agent deep dives usually take around 5 minutes. This feature serves as a safety net and may become essential when more complex services are added to the platform.

Response:

{
  "status": "1",
  "message": "Your task has been accepted by the system. Please verify that the information is correct.
    If it is, use the /v1/market/confirmtask endpoint using the task_id to confirm the task.
    Your task will not be completed until confirmation is received.",
  "task_id": "djrsbuwc",
  "contract_address": "0xB2ee01f57aEBD6E268934ed9Dc47B01Be760867D",
  "x_handle": "AgoraAgent",
  "start_time": 1740684453,
  "expiration_time": 1740770853,
  "last_updated": 1740684453
}

If your submission is accepted, the response will include the details of the task and a message with instructions to confirm the task. At this point the task has been accepted by the system but is not "open", meaning it will not be completed until confirmation is received.

Take note of the "task_id" - you will use this to confirm the task, to track the status of the task, and ultimately receive access to the report. If you forget to save the task id, you can always retrieve it from the Get Tasks by Account endpoint.

Example Requests:

cURL

curl -X 'POST' \
  'https://api.agoraagent.io/v1/market/newtask/agent-deep-dive' \
  -H 'accept: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "contract_address": "0xB2ee01f57aEBD6E268934ed9Dc47B01Be760867D",
  "x_handle": "AgoraAgent",
  "expiration": 1
}'

PowerShell

curl.exe -X POST "https://api.agoraagent.io/v1/market/newtask/agent-deep-dive" `
  -H "accept: application/json" `
  -H "X-API-Key: YOUR_API_KEY" `
  -H "Content-Type: application/json" `
  -d "{`
  `"contract_address`": `"0xB2ee01f57aEBD6E268934ed9Dc47B01Be760867D`",`
  `"x_handle`": `"AgoraAgent`",`
  `"expiration`": 1`
}"

Python

import requests

url = "https://api.agoraagent.io/v1/market/newtask/agent-deep-dive"
headers = {
    "accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "contract_address": "0xB2ee01f57aEBD6E268934ed9Dc47B01Be760867D",
    "x_handle": "AgoraAgent",
    "expiration": 1
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

JavaScript

fetch("https://api.agoraagent.io/v1/market/newtask/agent-deep-dive", {
    method: "POST",
    headers: {
        "accept": "application/json",
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "contract_address": "0xB2ee01f57aEBD6E268934ed9Dc47B01Be760867D",
        "x_handle": "AgoraAgent",
        "expiration": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

Notes:

While the reports are primarily geared towards analyzing virtual agent projects, they will work with any token contract address (on Ethereum, Solana, Base, Arbitrum, Optimism, Binance Smart Chain, Avalanche, or Poloygon) and any X account, even if it has nothing to do with crypto. Feel free to experiment!