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
  }'

{
  "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

​
addresses
array
required
Array of token contract addresses (max: 50 addresses per request)
​
includeMetrics
boolean
default:"true"
Include trading metrics (volume, price changes, transaction counts)
​
includeHolders
boolean
default:"true"
Include holder distribution data
​
includeSocials
boolean
default:"true"
Include social media links

​
Response

​
tokens
array
Array of token objects matching the requested addresses
​
notFound
array
Array of addresses that were not found or are invalid
​
errors
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
  }'