Post a request for an On-Chain Data service. You can input a token contract address and receive detailed on-chain analysis including holder distributions, whale activity, and more. Unlike the Agent Deep Dive service, this endpoint returns raw data as a json string rather that processed analysis of the metrics.
These are the parameters expected by this endpoint:
contract_address(string) – The contract address of the token that you would like to have analyzed. Data is currently available for tokens Ethereum, Solana, Base, Arbitrum, Optimism, Binance Smart Chain, Avalanche, and Polygon.
expiration(integer, optional) – Specify the number of hours to keep the task open, between 1 and 72 hours. If not completed within this period, credits will be refunded. Note: this service typically only takes a minute or two. The expiration feature is optional, mostly serving as a safety net and may become essential when more complex services are added to the platform.
Response:
{
"status": '2',
"message": 'Your task is being processed. Please check back periodically.',
"service": 'on-chain-data',
"task_id": 'loqweaqa',
"start_time": 1740983990,
"last_updated": 1740983990,
"contract_address": '0xb2ee01f57aebd6e268934ed9dc47b01be760867d'
}
This task does not require any further confirmation after submitting the request. If the submission is accepted, the task will automatically be added to the queue and no further input is needed from you. If the task fails for any reason, you will not be charged with a credit.
Take note of the task_id - you will use this to track the status of the task, and ultimately receive access to the results. If you forget to save the task id, you can always retrieve it from the endpoint. You can periodically check the status of your task using the endpoint with your task_id. Here is an example of what a completed task will return:
