API Documentation

Base URL:https://api.shinobi.trade

Authentication

Most API endpoints require a JWT Bearer token. Include it in the Authorization header of your requests.

Endpoints marked with the Public badge do not require authentication. They use IP-based rate limiting instead.

Authentication Header

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/volume" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Rankings

5 endpoints

GET/api/v1/solana/tokens/volume

Returns top 100 tokens ranked by USD trading volume in the last 24 hours

Parameters

Query Parameters

onlyTrackedbooleanIf true, only returns tokens tracked by the system with complete metadata (name, symbol, image, creation data)

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/volume" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213{
  "success": true,
  "data": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "volume_usd": 12500000,
      "txn_count": 45000,
      "unique_wallets": 8500,
      "latest_price": 95.5,
      "last_trade_time": 1706457600
    }
  ]
}

GET/api/v1/solana/tokens/volume/:timeframe

Returns top 100 tokens ranked by USD trading volume for specified timeframe

Parameters

Path Parameters

timeframe5m | 15m | 30m | 1h | 6h | 12h | 24hTime window for volume calculation

Query Parameters

onlyTrackedbooleanIf true, only returns tokens tracked by the system with complete metadata (name, symbol, image, creation data)

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/volume/:timeframe" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213{
  "success": true,
  "data": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "volume_usd": 12500000,
      "txn_count": 45000,
      "unique_wallets": 8500,
      "latest_price": 95.5,
      "last_trade_time": 1706457600
    }
  ]
}

GET/api/v1/solana/tokens/trending

Returns top 100 tokens ranked by transaction count in the last hour

Parameters

Query Parameters

onlyTrackedbooleanIf true, only returns tokens tracked by the system with complete metadata (name, symbol, image, creation data)

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/trending" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213{
  "success": true,
  "data": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "volume_usd": 12500000,
      "txn_count": 45000,
      "unique_wallets": 8500,
      "latest_price": 95.5,
      "last_trade_time": 1706457600
    }
  ]
}

GET/api/v1/solana/tokens/trending/:timeframe

Returns top 100 tokens ranked by transaction count for specified timeframe

Parameters

Path Parameters

timeframe5m | 15m | 30m | 1h | 6h | 12h | 24h

Query Parameters

onlyTrackedbooleanIf true, only returns tokens tracked by the system with complete metadata (name, symbol, image, creation data)

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/trending/:timeframe" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213{
  "success": true,
  "data": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "volume_usd": 12500000,
      "txn_count": 45000,
      "unique_wallets": 8500,
      "latest_price": 95.5,
      "last_trade_time": 1706457600
    }
  ]
}

GET/api/v1/solana/tokens/top-performers/:timeframe

Returns top performing tokens ranked by positive price change percentage. **Only includes gainers** (tokens with positive price change in the timeframe). Tokens with negative or zero price change are excluded.

Parameters

Path Parameters

timeframe5m | 15m | 30m | 1h | 6h | 12h | 24hTime window for performance calculation

Query Parameters

onlyTrackedbooleanIf true, only returns tokens tracked by the system with complete metadata (name, symbol, image, creation data)

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/top-performers/:timeframe" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213141516{
  "success": true,
  "data": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "volume_usd": 12500000,
      "txn_count": 45000,
      "unique_wallets": 8500,
      "latest_price": 95.5,
      "last_trade_time": 1706457600,
      "open_price": 0.0001,
      "current_price": 0.00015,
      "price_change_pct": 50
    }
  ]
}

Token Info

3 endpoints

GET/api/v1/solana/tokens/:tokenAddress/info

Returns detailed token information including: - Token metadata (name, symbol, creator) - All liquidity pools - Price change events - Risk metrics (snipers, bundlers, insider holdings) - Transaction counts

Parameters

Path Parameters

tokenAddressstringToken mint address

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/:tokenAddress/info" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123456789101112131415161718192021222324252627282930313233343536373839{
  "success": true,
  "data": {
    "token": {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "image": "https://...",
      "creator": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU"
    },
    "pools": [
      {
        "pool_address": "",
        "liquidity_usd": 0,
        "price_usd": 0
      }
    ],
    "events": {
      "priceChangePercentage": {
        "5m": 0,
        "1h": 0,
        "6h": 0,
        "24h": 0
      }
    },
    "risk": {
      "snipers": 0,
      "bundlers": 0,
      "insiders": 0,
      "top10HolderPercentage": 0
    },
    "buys": 123,
    "sells": 456,
    "txns": 789,
    "holders": 1000
  },
  "cached": false
}

GET/api/v1/solana/tokens/by-pool/:poolAddress

Resolves pool address to token mint, then returns comprehensive token info

Parameters

Path Parameters

poolAddressstringLiquidity pool address

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/by-pool/:poolAddress" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829303132333435363738394041{
  "success": true,
  "data": {
    "token": {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "image": "https://...",
      "creator": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU"
    },
    "pools": [
      {
        "pool_address": "",
        "liquidity_usd": 0,
        "price_usd": 0
      }
    ],
    "events": {
      "priceChangePercentage": {
        "5m": 0,
        "1h": 0,
        "6h": 0,
        "24h": 0
      }
    },
    "risk": {
      "snipers": 0,
      "bundlers": 0,
      "insiders": 0,
      "top10HolderPercentage": 0
    },
    "buys": 123,
    "sells": 456,
    "txns": 789,
    "holders": 1000
  },
  "cached": true,
  "poolAddress": "",
  "resolvedToken": ""
}

POST/api/v1/solana/tokens/multi/info

Retrieves token information for up to 20 tokens in a single request. Uses Redis MGET for cache lookups, then batch fetches cache misses.

Parameters

Request Body

tokensstring[]

cURL

123456curl -X POST "https://api.shinobi.trade/api/v1/solana/tokens/multi/info" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
  "tokens": "[\"value1\",\"value2\"]"
}'

Response

200 Response

12345678910111213141516171819202122232425262728293031323334353637383940414243444546{
  "success": true,
  "data": {
    "tokens": {
      "<tokenAddress>": {
        "token": {
          "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "name": "USD Coin",
          "symbol": "USDC",
          "decimals": 6,
          "image": "https://...",
          "creator": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU"
        },
        "pools": [
          {
            "pool_address": "",
            "liquidity_usd": 0,
            "price_usd": 0
          }
        ],
        "events": {
          "priceChangePercentage": {
            "5m": 0,
            "1h": 0,
            "6h": 0,
            "24h": 0
          }
        },
        "risk": {
          "snipers": 0,
          "bundlers": 0,
          "insiders": 0,
          "top10HolderPercentage": 0
        },
        "buys": 123,
        "sells": 456,
        "txns": 789,
        "holders": 1000
      }
    },
    "requested": 20,
    "found": 18,
    "cacheHits": 12,
    "cacheMisses": 6
  }
}

Holders

3 endpoints

GET/api/v1/solana/tokens/:tokenAddress/holders

Returns top 100 token holders sorted by balance

Parameters

Path Parameters

tokenAddressstring

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/:tokenAddress/holders" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123456789101112{
  "success": true,
  "data": [
    {
      "owner": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "amount": "1000000000",
      "decimals": 9,
      "ui_amount": 1,
      "percentage": 0.1
    }
  ]
}

GET/api/v1/solana/tokens/:tokenAddress/holders/top

Returns top 20 token holders with ownership percentages. ⚠️ Warning: Supply data may be unavailable for some tokens

Parameters

Path Parameters

tokenAddressstring

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/:tokenAddress/holders/top" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123456789101112{
  "success": true,
  "data": [
    {
      "owner": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "amount": "1000000000",
      "decimals": 9,
      "ui_amount": 1,
      "percentage": 0.1
    }
  ]
}

GET/api/v1/solana/tokens/:tokenAddress/holders/paginated

Returns token holders with cursor-based pagination

Parameters

Path Parameters

tokenAddressstring

Query Parameters

cursorstringCursor for pagination

limitnumberNumber of results per page

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/:tokenAddress/holders/paginated" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213141516171819{
  "success": true,
  "data": {
    "holders": [
      {
        "owner": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "amount": "1000000000",
        "decimals": 9,
        "ui_amount": 1,
        "percentage": 0.1
      }
    ],
    "pagination": {
      "limit": 25,
      "hasMore": true,
      "nextCursor": "5J7xN..."
    }
  }
}

Discovery

7 endpoints

GET/api/v1/solana/tokens/latest

Returns newly created tokens with pagination (max 10 pages)

Parameters

Query Parameters

pagenumber

limitnumber

liquiditynumberMinimum liquidity in USD

marketCapnumberMinimum market cap in USD

riskScorenumberMaximum risk score

holdersnumberMinimum number of holders

marketsstringComma-separated list of markets

ruggedbooleanInclude rugged tokens

reduceSpambooleanFilter out spam tokens

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/latest" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213141516171819202122232425{
  "success": true,
  "data": {
    "tokens": [
      {
        "mint": "",
        "name": "",
        "symbol": "",
        "image": "",
        "liquidity_usd": 0,
        "market_cap_usd": 0,
        "created_at": "2025-11-23T15:00:00Z",
        "graduated_at": "2025-11-23T15:00:00Z",
        "curve_percentage": 0
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "hasMore": true,
      "total": 1000,
      "pages": 20
    }
  }
}

GET/api/v1/solana/tokens/multi/graduated

Returns tokens that have migrated between launchpads/DEXs. Returns ALL migrations across all platforms (PumpFun→Raydium, PumpFun→Orca, etc.) **Note:** Includes tokens without metadata (name/symbol may be empty strings). The metadata service will fetch missing data on-demand when needed. Each token includes: - Basic metadata (mint, name, symbol, decimals, image, uri) - Migration data (pre_platform, post_platform, source_pool, destination_pool, migration_slot, migration_time, migration_tx) - Creation data (creator, created_time, creation_slot, creation_tx)

Parameters

Query Parameters

pagenumberPage number

limitnumberResults per page

launchpadstringFilter by launchpad (comma-separated). Matches EITHER source OR destination platform. Examples: - `?launchpad=pumpfun` - Migrations involving PumpFun - `?launchpad=pumpfun,raydium` - Migrations involving PumpFun OR Raydium Supported values: pumpfun, pumpswap, raydium, raydiumlaunchlab, orca, meteora, meteoradbc

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/multi/graduated" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213141516171819202122232425{
  "success": true,
  "data": {
    "tokens": [
      {
        "mint": "",
        "name": "",
        "symbol": "",
        "image": "",
        "liquidity_usd": 0,
        "market_cap_usd": 0,
        "created_at": "2025-11-23T15:00:00Z",
        "graduated_at": "2025-11-23T15:00:00Z",
        "curve_percentage": 0
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "hasMore": true,
      "total": 1000,
      "pages": 20
    }
  }
}

GET/api/v1/solana/tokens/multi/graduating

Returns PumpFun tokens with 40-99% bonding curve completion that have had balance changes in the last hour (actively trading)

Parameters

Query Parameters

pagenumber

limitnumber

minCurvenumberMinimum bonding curve completion percentage

maxCurvenumberMaximum bonding curve completion percentage

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/multi/graduating" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213141516171819202122232425{
  "success": true,
  "data": {
    "tokens": [
      {
        "mint": "",
        "name": "",
        "symbol": "",
        "image": "",
        "liquidity_usd": 0,
        "market_cap_usd": 0,
        "created_at": "2025-11-23T15:00:00Z",
        "graduated_at": "2025-11-23T15:00:00Z",
        "curve_percentage": 0
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "hasMore": true,
      "total": 1000,
      "pages": 20
    }
  }
}

GET/api/v1/solana/tokens/multi/all

Returns 10 tokens each from latest, graduating, and graduated categories

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/multi/all" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829303132333435363738394041424344{
  "success": true,
  "data": {
    "latest": [
      {
        "mint": "",
        "name": "",
        "symbol": "",
        "image": "",
        "liquidity_usd": 0,
        "market_cap_usd": 0,
        "created_at": "2025-11-23T15:00:00Z",
        "graduated_at": "2025-11-23T15:00:00Z",
        "curve_percentage": 0
      }
    ],
    "graduating": [
      {
        "mint": "",
        "name": "",
        "symbol": "",
        "image": "",
        "liquidity_usd": 0,
        "market_cap_usd": 0,
        "created_at": "2025-11-23T15:00:00Z",
        "graduated_at": "2025-11-23T15:00:00Z",
        "curve_percentage": 0
      }
    ],
    "graduated": [
      {
        "mint": "",
        "name": "",
        "symbol": "",
        "image": "",
        "liquidity_usd": 0,
        "market_cap_usd": 0,
        "created_at": "2025-11-23T15:00:00Z",
        "graduated_at": "2025-11-23T15:00:00Z",
        "curve_percentage": 0
      }
    ]
  }
}

GET/api/v1/public/tokens/newPublic

Returns newly created PumpFun tokens. No authentication required. IP-based rate limiting only. Cache TTL: 30 seconds.

Parameters

Query Parameters

limitnumber

cURL

12curl -X GET "https://api.shinobi.trade/api/v1/public/tokens/new" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829{
  "success": true,
  "data": {
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "",
        "name": "",
        "image": "",
        "creator": "",
        "platform": "PumpFun",
        "created_time": 0,
        "age_seconds": 0,
        "market_cap_sol": 0,
        "volume_24h_sol": 0,
        "holders": 0,
        "txns_24h": 0,
        "curve_percentage": 0,
        "pool_address": "",
        "migrated": true,
        "migration_time": 0,
        "dev_percentage": 0,
        "top10_percentage": 0
      }
    ],
    "count": 0
  },
  "cached": true
}

GET/api/v1/public/tokens/graduatingPublic

Returns PumpFun tokens at 40-99% bonding curve completion. No authentication required. IP-based rate limiting only. Cache TTL: 15 seconds.

Parameters

Query Parameters

limitnumber

cURL

12curl -X GET "https://api.shinobi.trade/api/v1/public/tokens/graduating" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829{
  "success": true,
  "data": {
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "",
        "name": "",
        "image": "",
        "creator": "",
        "platform": "PumpFun",
        "created_time": 0,
        "age_seconds": 0,
        "market_cap_sol": 0,
        "volume_24h_sol": 0,
        "holders": 0,
        "txns_24h": 0,
        "curve_percentage": 0,
        "pool_address": "",
        "migrated": true,
        "migration_time": 0,
        "dev_percentage": 0,
        "top10_percentage": 0
      }
    ],
    "count": 0
  },
  "cached": true
}

GET/api/v1/public/tokens/graduatedPublic

Returns recently migrated PumpFun tokens. No authentication required. IP-based rate limiting only. Cache TTL: 30 seconds.

Parameters

Query Parameters

limitnumber

cURL

12curl -X GET "https://api.shinobi.trade/api/v1/public/tokens/graduated" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829{
  "success": true,
  "data": {
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "",
        "name": "",
        "image": "",
        "creator": "",
        "platform": "PumpFun",
        "created_time": 0,
        "age_seconds": 0,
        "market_cap_sol": 0,
        "volume_24h_sol": 0,
        "holders": 0,
        "txns_24h": 0,
        "curve_percentage": 0,
        "pool_address": "",
        "migrated": true,
        "migration_time": 0,
        "dev_percentage": 0,
        "top10_percentage": 0
      }
    ],
    "count": 0
  },
  "cached": true
}

Analytics

3 endpoints

GET/api/v1/solana/stats/:token

Returns trading statistics across all pools for 6 timeframes (5m, 15m, 30m, 1h, 6h, 24h). Cached for 1 minute.

Parameters

Path Parameters

tokenstringToken mint address

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/stats/:token" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192{
  "5m": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "15m": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "30m": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "1h": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "6h": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "24h": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  }
}

GET/api/v1/solana/stats/:token/:pool

Returns trading statistics for a specific pool across 6 timeframes

Parameters

Path Parameters

tokenstring

poolstringPool address

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/stats/:token/:pool" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192{
  "5m": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "15m": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "30m": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "1h": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "6h": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  },
  "24h": {
    "buyers": 0,
    "sellers": 0,
    "volume": {
      "buys": 0,
      "sells": 0,
      "total": 0
    },
    "transactions": 0,
    "buys": 0,
    "sells": 0,
    "wallets": 0,
    "price": 0,
    "priceChangePercentage": 0
  }
}

GET/api/v1/solana/tokens/:tokenAddress/ath

Returns the highest price and market cap ever recorded for a token. ⚠️ Warning: May timeout on historical queries. Cached for 1 hour.

Parameters

Path Parameters

tokenAddressstring

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/tokens/:tokenAddress/ath" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123456{
  "highest_price": 0.00123,
  "highest_market_cap": 1234567,
  "timestamp": 1706457600,
  "pool_id": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj"
}

Search

2 endpoints

GET/api/v1/solana/search

Advanced token search with 40+ filter parameters. Max 20 filters per query. 30 second timeout.

Parameters

Query Parameters

querystringFull-text search across name, symbol, description

symbolstringSymbol prefix match

pagenumber

limitnumber

sortOrderasc | desc

hasImageboolean

hasSocialsboolean

minCreatedAtstringISO string or Unix timestamp

maxCreatedAtstring

minLiquiditynumber

maxLiquiditynumber

minMarketCapnumber

maxMarketCapnumber

minVolume24hnumber

maxVolume24hnumber

minHoldersnumber

maxHoldersnumber

freezeAuthorityboolean

mintAuthorityboolean

deployerstringDeployer wallet address

creatorstringCreator wallet address

minRiskScorenumber

maxRiskScorenumber

statusstring

marketstring

launchpadstring

twitterboolean

telegramboolean

discordboolean

websiteboolean

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/search" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253{
  "status": "success",
  "data": [
    {
      "mint": "",
      "name": "",
      "symbol": "",
      "decimals": 0,
      "image": "",
      "description": "",
      "has_socials": 0,
      "holder_count": 0,
      "launchpad": "",
      "jupiter_verified": 0,
      "liquidity_usd": 0,
      "market_cap_usd": 0,
      "price_usd": 0,
      "lp_burn_percentage": 0,
      "market": "",
      "quote_token": "",
      "has_freeze_authority": 0,
      "has_mint_authority": 0,
      "pool_address": "",
      "deployer_wallet": "",
      "creator": "",
      "status": "",
      "created_at": "2025-11-23T15:00:00Z",
      "graduated_at": "2025-11-23T15:00:00Z",
      "last_updated": "2025-11-23T15:00:00Z",
      "total_buys": 0,
      "total_sells": 0,
      "total_transactions": 0,
      "volume_24h": 0,
      "volume_total": 0,
      "top10_percentage": 0,
      "dev_percentage": 0,
      "insiders_percentage": 0,
      "snipers_count": 0,
      "bundlers_count": 0,
      "risk_score": 0,
      "has_twitter": 0,
      "has_telegram": 0,
      "has_discord": 0,
      "has_website": 0,
      "fees_total": 0,
      "curve_percentage": 0
    }
  ],
  "page": 0,
  "pages": 0,
  "total": 0,
  "hasMore": true
}

GET/api/v1/solana/deployer/:wallet

Returns all tokens created by a specific deployer wallet. By default (enrich=true), each token is enriched with full information including: - Pools (liquidity, price, market cap, transactions) - Events (price change percentages) - Risk analysis (snipers, bundlers, insiders, top10 holders, rugged status) - Transaction counts (buys, sells, total txns) - Holder count Same enriched data as `/api/v1/solana/tokens/{tokenAddress}/info` endpoint.

Parameters

Path Parameters

walletstringSolana wallet address (32-44 base58 characters)

Query Parameters

pagenumberPage number

limitnumberResults per page

enrichbooleanEnrich each token with full info (pools, events, risk, etc.). Set to false for basic metadata only (faster response, less data).

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/deployer/:wallet" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123456789101112131415161718192021{
  "status": "success",
  "data": [
    {
      "mint": "",
      "name": "",
      "symbol": "",
      "image": "",
      "created_at": "2025-11-23T15:00:00Z",
      "market_cap_usd": 0,
      "liquidity_usd": 0,
      "total_transactions": 0,
      "status": "",
      "launchpad": "",
      "holder_count": 0
    }
  ],
  "page": 0,
  "pages": 0,
  "total": 0
}

Trades

4 endpoints

GET/api/v1/solana/trades/:tokenAddress

Returns all trades across all pools for a token with cursor-based pagination

Parameters

Path Parameters

tokenAddressstring

Query Parameters

cursorstringTransaction signature to paginate from

limitnumber

showMetabooleanInclude metadata fields

parseJupiterbooleanParse Jupiter aggregator trades

hideArbbooleanHide arbitrage trades

sortDirectionasc | desc

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/trades/:tokenAddress" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

12345678910111213141516171819202122232425{
  "success": true,
  "data": {
    "tokenAddress": "",
    "trades": [
      {
        "signature": "",
        "block_time": 0,
        "owner": "",
        "pool_id": "",
        "input_mint": "",
        "output_mint": "",
        "input_amount": 0,
        "output_amount": 0,
        "price": 0,
        "side": "buy"
      }
    ],
    "pagination": {
      "limit": 25,
      "hasMore": true,
      "nextCursor": "5J7xN..."
    }
  }
}

GET/api/v1/solana/trades/pool/:poolAddress

Returns all trades for a specific pool with cursor-based pagination. Since a pool only has two tokens, this is more efficient than token-specific queries.

Parameters

Path Parameters

poolAddressstringPool address to get trades for

Query Parameters

cursorstringTransaction signature to paginate from

limitnumberNumber of results per page

showMetabooleanInclude metadata fields

parseJupiterbooleanParse Jupiter aggregator trades

hideArbbooleanHide arbitrage trades

sortDirectionasc | descSort direction

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/trades/pool/:poolAddress" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123{
  "success": true
}

GET/api/v1/solana/trades/pool/:poolAddress/wallet/:owner

Returns trades for a specific pool filtered by wallet address with cursor-based pagination

Parameters

Path Parameters

poolAddressstringPool address to get trades for

ownerstringWallet address to filter trades by

Query Parameters

cursorstringTransaction signature to paginate from

limitnumberNumber of results per page

showMetabooleanInclude metadata fields

parseJupiterbooleanParse Jupiter aggregator trades

hideArbbooleanHide arbitrage trades

sortDirectionasc | descSort direction

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/trades/pool/:poolAddress/wallet/:owner" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

123{
  "success": true
}

GET/api/v1/solana/trades/:tokenAddress/by-wallet/:owner

Returns all trades for a token filtered by wallet address

Parameters

Path Parameters

tokenAddressstring

ownerstringWallet address

Query Parameters

cursorstring

limitnumber

showMetaboolean

parseJupiterboolean

hideArbboolean

sortDirectionasc | desc

cURL

123curl -X GET "https://api.shinobi.trade/api/v1/solana/trades/:tokenAddress/by-wallet/:owner" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json"

Response

200 Response

1234567891011121314151617181920212223242526{
  "success": true,
  "data": {
    "tokenAddress": "",
    "owner": "",
    "trades": [
      {
        "signature": "",
        "block_time": 0,
        "owner": "",
        "pool_id": "",
        "input_mint": "",
        "output_mint": "",
        "input_amount": 0,
        "output_amount": 0,
        "price": 0,
        "side": "buy"
      }
    ],
    "pagination": {
      "limit": 25,
      "hasMore": true,
      "nextCursor": "5J7xN..."
    }
  }
}