curl -X POST "https://inkypump.com/api/tokens/batch" \
-H "Content-Type: application/json" \
-d '{
"addresses": [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
]
}'
curl -X POST "https://inkypump.com/api/tokens/batch" \
-H "Content-Type: application/json" \
-d '{
"addresses": [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
],
"includeMetrics": false,
"includeHolders": true
}'
const addresses = [
'0x1234567890abcdef1234567890abcdef12345678',
'0x9876543210fedcba9876543210fedcba98765432'
];
const response = await fetch('https://inkypump.com/api/tokens/batch', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({ addresses })
});
const data = await response.json();
const minimalResponse = await fetch('https://inkypump.com/api/tokens/batch', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
addresses,
includeMetrics: false,
includeHolders: true
})
});
const minimalData = await minimalResponse.json();
import requests
addresses = [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
]
response = requests.post(
"https://inkypump.com/api/tokens/batch",
json={"addresses": addresses}
)
data = response.json()
minimal_response = requests.post(
"https://inkypump.com/api/tokens/batch",
json={
"addresses": addresses,
"includeMetrics": False,
"includeHolders": True
}
)
minimal_data = minimal_response.json()
{
"tokens": [
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"created_at": "2024-01-15T10:30:00Z",
"owner": "0xabcdef1234567890abcdef1234567890abcdef12",
"name": "Moon Token",
"ticker": "MOON",
"description": "To the moon and beyond",
"image_url": "https://example.com/moon-logo.png",
"telegram": "https://t.me/moontoken",
"twitter": "https://twitter.com/moontoken",
"website": "https://moontoken.com",
"market_cap": 500.5,
"funding_progress": 1.0,
"price_eth": 0.00125,
"volume_24h": 250.8,
"price_change_24h": 15.3,
"txns_24h_buys": 425,
"txns_24h_sells": 312,
"total_holders": 1250,
"top_10_percentage": 35.2,
"dev_holding_percentage": 5.0,
"is_graduated": true
},
{
"address": "0x9876543210fedcba9876543210fedcba98765432",
"created_at": "2024-01-14T08:15:00Z",
"owner": "0xfedcba9876543210fedcba9876543210fedcba98",
"name": "Star Token",
"ticker": "STAR",
"description": "Reach for the stars",
"image_url": "https://example.com/star-logo.png",
"telegram": "https://t.me/startoken",
"twitter": null,
"website": null,
"market_cap": 125.3,
"funding_progress": 0.65,
"price_eth": 0.00089,
"volume_24h": 45.2,
"price_change_24h": -5.2,
"txns_24h_buys": 89,
"txns_24h_sells": 67,
"total_holders": 423,
"top_10_percentage": 48.7,
"dev_holding_percentage": 10.0,
"is_graduated": false
}
],
"notFound": [
"0xinvalidaddress123"
],
"errors": []
}
InkyPump API
Batch Token Lookup
Get multiple tokens by their addresses in a single request
POST
/
api
/
tokens
/
batch
curl -X POST "https://inkypump.com/api/tokens/batch" \
-H "Content-Type: application/json" \
-d '{
"addresses": [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
]
}'
curl -X POST "https://inkypump.com/api/tokens/batch" \
-H "Content-Type: application/json" \
-d '{
"addresses": [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
],
"includeMetrics": false,
"includeHolders": true
}'
const addresses = [
'0x1234567890abcdef1234567890abcdef12345678',
'0x9876543210fedcba9876543210fedcba98765432'
];
const response = await fetch('https://inkypump.com/api/tokens/batch', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({ addresses })
});
const data = await response.json();
const minimalResponse = await fetch('https://inkypump.com/api/tokens/batch', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
addresses,
includeMetrics: false,
includeHolders: true
})
});
const minimalData = await minimalResponse.json();
import requests
addresses = [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
]
response = requests.post(
"https://inkypump.com/api/tokens/batch",
json={"addresses": addresses}
)
data = response.json()
minimal_response = requests.post(
"https://inkypump.com/api/tokens/batch",
json={
"addresses": addresses,
"includeMetrics": False,
"includeHolders": True
}
)
minimal_data = minimal_response.json()
{
"tokens": [
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"created_at": "2024-01-15T10:30:00Z",
"owner": "0xabcdef1234567890abcdef1234567890abcdef12",
"name": "Moon Token",
"ticker": "MOON",
"description": "To the moon and beyond",
"image_url": "https://example.com/moon-logo.png",
"telegram": "https://t.me/moontoken",
"twitter": "https://twitter.com/moontoken",
"website": "https://moontoken.com",
"market_cap": 500.5,
"funding_progress": 1.0,
"price_eth": 0.00125,
"volume_24h": 250.8,
"price_change_24h": 15.3,
"txns_24h_buys": 425,
"txns_24h_sells": 312,
"total_holders": 1250,
"top_10_percentage": 35.2,
"dev_holding_percentage": 5.0,
"is_graduated": true
},
{
"address": "0x9876543210fedcba9876543210fedcba98765432",
"created_at": "2024-01-14T08:15:00Z",
"owner": "0xfedcba9876543210fedcba9876543210fedcba98",
"name": "Star Token",
"ticker": "STAR",
"description": "Reach for the stars",
"image_url": "https://example.com/star-logo.png",
"telegram": "https://t.me/startoken",
"twitter": null,
"website": null,
"market_cap": 125.3,
"funding_progress": 0.65,
"price_eth": 0.00089,
"volume_24h": 45.2,
"price_change_24h": -5.2,
"txns_24h_buys": 89,
"txns_24h_sells": 67,
"total_holders": 423,
"top_10_percentage": 48.7,
"dev_holding_percentage": 10.0,
"is_graduated": false
}
],
"notFound": [
"0xinvalidaddress123"
],
"errors": []
}
Description
Fetches detailed information for multiple tokens in a single request. This endpoint is optimized for applications that need to retrieve data for multiple tokens efficiently, such as portfolio trackers or analytics dashboards.Request Body
array
required
Array of token contract addresses (max: 50 addresses per request)
boolean
default:"true"
Include trading metrics (volume, price changes, transaction counts)
boolean
default:"true"
Include holder distribution data
boolean
default:"true"
Include social media links
Response
array
Array of token objects matching the requested addresses
Show Token Object
Show Token Object
string
Token contract address
string
ISO timestamp of token creation
string
Creator’s wallet address
string
Token name
string
Token symbol
string
Token description
string
Token logo URL
string
Telegram channel URL (if includeSocials=true)
string
Twitter/X profile URL (if includeSocials=true)
string
Official website URL (if includeSocials=true)
number
Current market capitalization in ETH
number
Funding progress (0-1, where 1 means fully funded)
number
Current token price in ETH
number
24-hour trading volume (if includeMetrics=true)
number
24-hour price change percentage (if includeMetrics=true)
number
Number of buy transactions in the last 24 hours (if includeMetrics=true)
number
Number of sell transactions in the last 24 hours (if includeMetrics=true)
number
Total number of token holders (if includeHolders=true)
number
Percentage of supply held by top 10 holders (if includeHolders=true)
number
Percentage of supply held by developer (if includeHolders=true)
boolean
Whether the token has completed funding
array
Array of addresses that were not found or are invalid
array
Array of any errors encountered during processing
{
"tokens": [
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"created_at": "2024-01-15T10:30:00Z",
"owner": "0xabcdef1234567890abcdef1234567890abcdef12",
"name": "Moon Token",
"ticker": "MOON",
"description": "To the moon and beyond",
"image_url": "https://example.com/moon-logo.png",
"telegram": "https://t.me/moontoken",
"twitter": "https://twitter.com/moontoken",
"website": "https://moontoken.com",
"market_cap": 500.5,
"funding_progress": 1.0,
"price_eth": 0.00125,
"volume_24h": 250.8,
"price_change_24h": 15.3,
"txns_24h_buys": 425,
"txns_24h_sells": 312,
"total_holders": 1250,
"top_10_percentage": 35.2,
"dev_holding_percentage": 5.0,
"is_graduated": true
},
{
"address": "0x9876543210fedcba9876543210fedcba98765432",
"created_at": "2024-01-14T08:15:00Z",
"owner": "0xfedcba9876543210fedcba9876543210fedcba98",
"name": "Star Token",
"ticker": "STAR",
"description": "Reach for the stars",
"image_url": "https://example.com/star-logo.png",
"telegram": "https://t.me/startoken",
"twitter": null,
"website": null,
"market_cap": 125.3,
"funding_progress": 0.65,
"price_eth": 0.00089,
"volume_24h": 45.2,
"price_change_24h": -5.2,
"txns_24h_buys": 89,
"txns_24h_sells": 67,
"total_holders": 423,
"top_10_percentage": 48.7,
"dev_holding_percentage": 10.0,
"is_graduated": false
}
],
"notFound": [
"0xinvalidaddress123"
],
"errors": []
}
curl -X POST "https://inkypump.com/api/tokens/batch" \
-H "Content-Type: application/json" \
-d '{
"addresses": [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
]
}'
curl -X POST "https://inkypump.com/api/tokens/batch" \
-H "Content-Type: application/json" \
-d '{
"addresses": [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
],
"includeMetrics": false,
"includeHolders": true
}'
const addresses = [
'0x1234567890abcdef1234567890abcdef12345678',
'0x9876543210fedcba9876543210fedcba98765432'
];
const response = await fetch('https://inkypump.com/api/tokens/batch', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({ addresses })
});
const data = await response.json();
const minimalResponse = await fetch('https://inkypump.com/api/tokens/batch', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
addresses,
includeMetrics: false,
includeHolders: true
})
});
const minimalData = await minimalResponse.json();
import requests
addresses = [
"0x1234567890abcdef1234567890abcdef12345678",
"0x9876543210fedcba9876543210fedcba98765432"
]
response = requests.post(
"https://inkypump.com/api/tokens/batch",
json={"addresses": addresses}
)
data = response.json()
minimal_response = requests.post(
"https://inkypump.com/api/tokens/batch",
json={
"addresses": addresses,
"includeMetrics": False,
"includeHolders": True
}
)
minimal_data = minimal_response.json()
⌘I