zSignals API

Trending Tokens

Get trending tokens sorted by volume and market activity

Endpoint

GET /v1/market/trending

Request Examples

curl -X GET "https://api.zsignals.xyz/v1/market/trending" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
            
          
const response = await fetch('https://api.zsignals.xyz/v1/market/trending', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json'
  }
});

const data = await response.json();
console.log(data);
            
          
import requests

response = requests.get(
    'https://api.zsignals.xyz/v1/market/trending',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Accept': 'application/json'
    }
)

data = response.json()
print(data)
            
          
require 'net/http'
require 'json'

uri = URI('https://api.zsignals.xyz/v1/market/trending')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Accept'] = 'application/json'

response = http.request(request)
data = JSON.parse(response.body)
puts data

Query Parameters

Parameter Type Description Default
limit integer Number of results to return (1-100) 100
offset integer Skip this many results (for pagination) 0
timeframe string Time period: 1h, 24h, 7d, 30d 24h
sort string Sort by: volume, market_cap, change, holders volume
order string Sort order: asc or desc desc

Example with Parameters

curl -X GET "https://api.zsignals.xyz/v1/market/trending?limit=10&offset=0&sort=volume&order=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Schema

Field Type Description
rankintegerPosition in trending list
symbolstringToken ticker symbol
namestringFull token name
contract_addressstringEthereum contract address
price_usddecimalCurrent price in USD
market_capdecimalMarket capitalization in USD
volume_24hdecimal24-hour trading volume in USD
holders_countintegerNumber of token holders
change_24hdecimal24-hour price change percentage
change_7ddecimal7-day price change percentage

Error Responses

400 Bad Request

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid limit parameter: must be between 1 and 100",
    "details": {
      "parameter": "limit",
      "provided": 150,
      "allowed": "1-100"
    }
  }
}

401 Unauthorized

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key",
    "details": {
      "help": "Include your API key in the Authorization header"
    }
  }
}

429 Too Many Requests

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "details": {
      "limit": 100,
      "remaining": 0,
      "reset_at": "2024-01-15T12:00:00Z"
    }
  }
}