* 请求方法：POST
* 功能描述：提交代币CA并获取AI分析代币叙事结果
* api-key: your key (需要链智提供)
**请求参数与返回样例：**
```python
// python代码调用示例
def get_narration(url, contractAddress, chain='Solana', language='en'):
'''
contractAddress string ca 必需
chain string 必需 目前只支持 Solana
language string 可选 语言, en 为英文, 其他返回中文
'''
headers = {
'Content-Type': 'application/json',
'API-KEY':your key (需要链智提供)
}
data = {
"contractAddress": contractAddress,
"chain": chain,
"language": language
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
contractAddress = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
url = 'https://ai_narration.chaininsight.vip/api/v1/narration'
get_narration(url, contractAddress, chain='Solana', language='en')
```
```python
// 返回样例
{
"contractAddress": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"chain": "Solana"
}
{
"reqId": "XXXXXXXXXXXXXXXXX",
"code": 0,
"data": {
"narrative": "TYGA的叙事特色在于每笔交易仿佛一场说唱对决，承诺为用户积累财富。与Tyga的明星身份紧密相连，TYGA通过社交媒体和直播直接与粉丝互动，获得了强大的社区支持，并通过现场销毁活动进一步增强了其影响力。"
},
"msg": "请求成功"
}
```
### **3.3 KOL交易推送**
* 订阅ip+端口：IP [43.159.57.127](http://43.159.57.127) Port: 19999
* topic: prod-tob-kol-transaction-update
* group-id: {第三方使用者名}（如：chaininsight）
* api-key: your key (需要链智提供)
调用示例
```python
from confluent_kafka import Consumer, KafkaException
conf = {
'bootstrap.servers': '43.159.57.127:19999',
'security.protocol': 'SASL_PLAINTEXT',
'sasl.mechanism': 'SCRAM-SHA-256',
'sasl.username': 'YOUR_USERNAME', # TODO: Replace with your username and password given by ChainInsight
'sasl.password': 'YOUR_PASSWORD',
'group.id': 'YOUR_CONSUMER_GROUP_ID', # TODO: Replace with your consumer group ID, highly recommended to use a unique group ID for each consumer with your company name attached to it, like "ChainInsight-Dev"
'auto.offset.reset': 'earliest'
}
consumer = Consumer(conf)
topic_name = "prod-tob-kol-transaction-update"
consumer.subscribe([topic_name])
print(f"✅ Listening to topic: {topic_name}")
try:
while True:
msg = consumer.poll(1.0)
if msg is None:
continue
if msg.error():
raise KafkaException(msg.error())
print(f"📩 Received message: key={msg.key()}, value={msg.value().decode('utf-8')}")
# TODO: Process the message here
except KeyboardInterrupt:
print("🛑 Stopped by user")
finally:
consumer.close()
```
**可提供的字段详情：**
| 字段名 | 字段 | 备注 | ToB是否开放 | 排序 |
| -------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -- |
| createTime | 交易时间 | unix毫秒时间戳 | ✅ | ✅ |
| kol | kol信息（含id, name, avatar, twitterId, desc） | | ✅ | |
| fromToken | 卖出代币 | | ✅ | |
| fromTokenCount | 卖出代币数量 | 数据已格式化 | ✅ | |
| fromTokenAddress | 卖出代币地址 | | ✅ | |
| fromTokenRemainCount | 卖出代币余额 | 数据已格式化 | ✅ | |
| toToken | 买入代币 | | ✅ | |
| toTokenCount | 买入代币数量 | 数据已格式化 | ✅ | |
| toTokenAddress | 买入代币地址 | | ✅ | |
| toTokenRemainCount | 买入代币余额 | 数据已格式化 | ✅ | |
| chainName | 交易所在链 | Ethereum, Base, BSC, Solana, 可能需要自己格式化大小写 | ✅ | ✅ |
| token | 目标代币（非稳定币） | | ✅ | |
| tokenAddress | 目标代币地址 | | ✅ | |
| tokenPriceChatLinks | 目标代币CEX链接 | 为json类型，样例为
{
"axiom": "链接", // 仅为Solana链有
"ave": "链接", // 必有
"gmgn": "链接", // 必有
"okx": "链接", // 必有
"default": "dexscreener链接" // 必有
}
| ✅ | |
| tokenRemainCount | 目标代币余额 | | ✅ | |
| usdtPrice | 买入价格 | 数据已格式化 | ✅ | |
| actionType | 当前状态 | 0或null：默认
1：建仓
2：加仓
3：部分卖出
4：全部卖出
| ✅ | |
| recentBuyerKols | 近期买入目标代币的KOL（含id, name, avatar） | | ✅ | |
| recentSellerKols | 近期卖出目标代币的KOL（含id, name, avatar） | | ✅ | |
| transactionHash | 脱敏的交易哈希（敏感信息） | | ✅ | |
### **3.4 AI社群总结**
* 接口地址：
* 每日热点总结：
* 全网社群讨论：
* 请求方法：POST，http请求方式，由客户方主动发起请求
* 功能描述：获取AI生成的社群总结，每日的热点总结
* api-key: your key (需要链智提供)
**请求示例函数：**
```python
// 每日热点总结
def get_daily_summary(url, timestamp=None):
'''
该接口配置非必填的timestamp字段。
若提供timestamp字段，则会返回<=timestamp的同一批最新数据；
若不提供timestamp字段，则会返回所有数据中最新一批数据；
'''
headers = {
'Content-Type': 'application/json',
'API-KEY': your key (需要链智提供)
}
if timestamp is None:
data = {}
else:
data = {
"timestamp": None
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
// 全网社群讨论
def get_realtime_summary(url, timestamp=None):
'''
该接口配置非必填的timestamp字段。
若提供timestamp字段，则会返回<=timestamp的同一批最新数据；
若不提供timestamp字段，则会返回所有数据中最新一批数据；
'''
headers = {
'Content-Type': 'application/json',
'API-KEY': your key (需要链智提供)
}
if timestamp is None:
data = {}
else:
data = {
"timestamp": None
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
```
#### 返回样例
```python
// 每日热点总结
"reqId":"222438773353484288",
"code":0,
"data":{
"list":[
{
"id":"376",
"timestamp":"1743490800000",
"projectName":"4444",
"projectAnalysis":"BSC/BNB链上的现象级代B，社群讨论极为热烈。市值峰值达$4.48M，12小时内涨幅高达4497.58%。合*开源且流动性锁定，但存在剧烈价格波动和KOL喊单出货风险。开发者行为引发疑虑，持仓分散但安全审计通过。叙事涵盖地址标准化及DeFi/GameFi生态，推特粉丝28.3万。",
"relatedTokens":[
{
"ca":"xXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"chain":"bsc",
"viral":34,
"tokenPriceChatLinks":{
"default":"https://dexscreener.com/0x661af369690a8f5591cc0df7d581c83d1a6e4444/bsc"
},
"hasBeenRequested":false
}
],
"source":[
{
"id":"1878411934248890369",
"name":"XXXXXXX",
"avatar":"https://img.chaininsight.vip/image/_4330fee1-15f4-4e5e-8350-99d2ed47fc83.jpg"
},
],
"heat":1,
"createTime":"1743564904301",
"relatedLinks":[
"https://twitter.com/first4444onbsc",
"https://app.bubblemaps.io/bsc/token/0x661Af369690a8f5591CC0df7D581C83d1A6e4444"
]
}
],
"pageNum":1,
"pageSize":100,
"total":475
},
"msg":"请求成功"
}
```
```python
// 全网社群讨论
{
"reqId":"222438714876497920",
"code":0,
"data":{
"list":[
{
"id":"5717",
"timestamp":"1744120200000",
"projectName":"XX项目",
"projectAnalysis":"社群讨论聚焦于……",
"relatedTokens":{
},
"source":[
{
"id":"1906946254156566530",
"name":"XX群",
"avatar":"https://img.chaininsight.vip/image/_85107d2a-03e0-4874-a057-618b2df36593.jpg"
}
],
"heat":5,
"createTime":"1744120553622",
"relatedLinks":{
},
"summaryTimeblock":[
"1744119601000",
"1744120200000"
]
}
],
"pageNum":1,
"pageSize":10,
"total":5716
},
"msg":"请求成功"
}
```
### **3.5** 代币市场数据检测（**MemeRadar）**
* 接口地址：
【KOL交易分析】接口：
【社群讨论度指标 V2】接口：
【社群讨论度直接 call channel】接口：
*
* 请求方法：POST
* 功能描述：获取MemeRadar对代币交易信息的分析，包括：
* KOL交易情况
* 社群讨论情况
* 扫链信号情况
* TG+推特喊单情况
* api-key: your key (需要链智提供)
请求示例函数：
\# =========== 【KOL交易分析】接口请求示例 ===========
```python
// KOL交易分析
url = 'https://memeradar.chaininsight.vip/api/v1/kol_analysis_by_token'
headers = {
'Content-Type': 'application/json',
'API-KEY': your key (需要链智提供)
}
data = {
"contractAddress": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
```
\# =========== 【社群讨论度指标 V2】接口请求示例 ===========
```python
// 社群讨论度指标 V2
url = 'https://memeradar.chaininsight.vip/api/v1/analyze_token_community_v2'
headers = {
'Content-Type': 'application/json',
'API-KEY': your key (需要链智提供)
}
data = {
"contractAddress": "XXXXXXXXXXXXXXXXXXXXX",
"chain": "Solana"
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
```
\# =========== 【社群讨论度直接 call channel】接口请求示例 ===========
```python
// 社群讨论度直接 call channel
url = 'https://memeradar.chaininsight.vip/api/v1/analyze_token_call_channel'
headers = {
'Content-Type': 'application/json',
'API-KEY': your key (需要链智提供)
}
data = {
"contractAddress": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"chain": "Solana"
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
```
#### 返回的数据格式和示例
**【KOL交易分析】接口**
```python
// 【KOL交易分析】返回样例
{
"reqId":"2XXXXXXXXXXXXXXXXX0",
"code":0,
"data":{
"buyerCount":"3",
"clearCount":"3",
"tradeStatList":[
{
"name":"XXXX",
"rawAmountBought":17XXXXX51.37,
"amountBought":"17XX2.85K",
"sellRatio":"100%"
},
{
"name":"XXXX",
"rawAmountBought":55XX36.00,
"amountBought":"5XX9.04K",
"sellRatio":"100%"
},
{
"name":"XX",
"rawAmountBought":5XX971.36,
"amountBought":"5XX7.97K",
"sellRatio":"100%"
}
]
},
"msg":"请求成功"
}
```
**【社群讨论度指标 V2】接口**
```python
// 【社群讨论度指标 V2】返回样例
{
"reqId": "134766631225266176",
"code": 0,
"msg": "请求成功",
"data": {
"communityAttentionInfo": {
"communityCount": 2,
"mentionCount": 5,
"communityAttentions": [
{
"groupName": "name1",
"kolName": "JAMES",
"avatar": "https://img.chaininsight.info/image/_7xxxxxxxx814be7ac9.jpg",
"kolTwitterId": "corleonefnf",
"totalMentionCount": 2,
"kolMentionCount": 1
},
{
"groupName": "name2",
"kolName": "0xsun",
"avatar": "https://img.chaininsight.info/image/_7XXXXXXXXXXXXXX14be7ac9.jpg",
"kolTwitterId": "0xsun",
"totalMentionCount": 3,
"kolMentionCount": 2
}
]
},
"alertChanceInfo": {
"count": 2,
"alertChances": [
{
"publisherId": 1,
"publisherName": "moonshoot",
"timestamp": 1735226374000
},
{
"publisherId": 2,
"publisherName": "XXXXXX",
"timestamp": 1735226384000
}
]
}
}
```
**【社群讨论度直接 call channel】接口**
```python
// 【社群讨论度直接 call channel】返回样例
{
"reqId": "134766631225266176",
"code": 0,
"msg": "请求成功",
"data": {
"callChannelInfo": {
"count": 2,
"callChannels": [
{
"channelName": "channel1",
"channelLink": "https://t.me/MarkDegens/14881",
"marketCap": "105K",
"timestamp": 1735226384000
},
{
"channelName": "channel2",
"channelLink": "https://t.me/MaybachCalls/8906",
"marketCap": "103K",
"timestamp": 1735226374000
}
]
}
}
}
```
### **3.6** 查询推特用户钱包地址接口
* 接口地址：
* 请求方法：POST
* 功能描述：根据推特的username查询 对应的钱包地址 及 title
* api-key: your key (需要链智提供)
请求示例函数：
```python
// 查询推特用户钱包地址接口 请求示例
import requests
url = 'https://tw_info.chaininsight.vip/api/v1/twitter_info'
headers = {
'Content-Type': 'application/json',
'API-KEY': 'your_key',
}
data = {
"screenName": '0xSunNFT',
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
print(response.status_code)
print(response.json())
```
返回结果参考：
```python
// 查询推特用户钱包地址接口 返回结果
{
"code": 0,
"data": {
"name": "0xSun",
"profileImageUrl": "https://pbs.twimg.com/profile_images/1820705442735296512/ej9BX01I_normal.png",
"screenName": "0xSunNFT",
"title": "0xSun Group Founder",
"twitterUrl": "https://x.com/0xSunNFT",
"wallets": [
{
"address": "HUpPyLU8KWisCAr3mzWy2FKT6uuxQ2qGgJQxyTpDoes5",
"chain": "sol",
"count": 598,
"tags": [
{"category": 99, "count": 347, "tagName": "0xsun"},
{"category": 99, "count": 89, "tagName": "Alpha"},
{"category": 99, "count": 62, "tagName": "On-chain King"},
{"category": 99, "count": 57, "tagName": "Sun哥"},
{"category": 99, "count": 32, "tagName": "High Win Rate"}
]
},
{
"address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"chain": "sol",
"count": 31,
"tags": [
{"category": 99, "count": 9, "tagName": "beaniemaxi"},
{"category": 99, "count": 3, "tagName": "0xSun's Alt"},
{"category": 99, "count": 2, "tagName": "Insider"},
{"category": 99, "count": 2, "tagName": "Alpha"},
{"category": 99, "count": 2, "tagName": "Penguin Team Affiliate"}
]
},
{
"address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"chain": "sol",
"count": 9,
"tags": [
{"category": 99, "count": 7, "tagName": "0xsun"},
{"category": 99, "count": 1, "tagName": "Dean"}
]
},
{
"address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"chain": "sol"
}
]
},
"msg": "请求成功",
"reqId": "264415067582369793"
}
```
### **3.7** 查询推特大v数及前20详情接口
* 功能维护中
---
# 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://chaininsight-3.gitbook.io/api/documentation.md?ask=
```
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.