z100 Creators Endpoint - zSignals API

Endpoint

GET /v1/z100/creators

Live Example Response

LIVE DATA

Updated every minute

[
  {
    "rank": 1,
    "handle": "jessepollak",
    "name": "jessepollak",
    "creator_address": "0x2211d1d0020daea8039e46cf1367962070d77da9",
    "portfolio_value": "$10.4M",
    "portfolio_value_raw": 10395910.24,
    "volume_24h": "$117.6K",
    "total_volume": "$31.5M",
    "unique_holders": 30153,
    "change_24h": "-0.7%"
  },
  {
    "rank": 2,
    "handle": "propaganda",
    "name": "propaganda",
    "creator_address": "0xc51e259376eda667d831816e78b22dc90171d9ac",
    "portfolio_value": "$2.2M",
    "portfolio_value_raw": 2173222.86,
    "volume_24h": "$2.6K",
    "total_volume": "$15.5M",
    "unique_holders": 29653,
    "change_24h": "+1.7%"
  },
  {
    "rank": 3,
    "handle": "balajis",
    "name": "balajis",
    "creator_address": "0xdde8346b13d089cca8c0c70c370a84e83e9ecb14",
    "portfolio_value": "$2.2M",
    "portfolio_value_raw": 2167501.89,
    "volume_24h": "$1.4K",
    "total_volume": "$22.8M",
    "unique_holders": 10449,
    "change_24h": "+0.5%"
  }
]

Request Examples

curl -X GET "https://api.zsignals.xyz/v1/z100/creators" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const response = await fetch('https://api.zsignals.xyz/v1/z100/creators', {
  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/z100/creators',
    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/z100/creators')
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
`period`	string	Time period: 1h, 4h, 24h, 7d	24h
`sort_by`	string	Sort by: rank, price, market_cap, volume, total_volume, holders, price_change, market_cap_change, volume_change, holders_change	rank
`sort_order`	string	Sort order: asc or desc	desc
`include_changes`	boolean	Include historical comparison data	true
`order`	string	Sort order: asc or desc	desc

Example with Parameters

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

Response Schema

Response includes period-specific change data when include_changes=true (default).

Field	Type	Description
`rank`	integer	z100 ranking position
`handle`	string	Creator handle or ENS name
`name`	string	Display name
`creator_address`	string	Creator wallet address
`token_address`	string	Token contract address
`pool_id`	string	Primary Uniswap pool ID
`price_usd`	decimal	Current token price in USD
`market_cap`	decimal	Current market capitalization
`volume_24h`	decimal	24-hour trading volume
`total_volume`	decimal	All-time trading volume
`unique_holders`	integer	Total number of holders
`is_new`	boolean	New to Z100 in this period
`price_change_percent`	decimal	Price change % for period
`price_is_up`	boolean	Price direction
`market_cap_change_percent`	decimal	Market cap change % for period
`market_cap_change_value`	decimal	Market cap absolute change
`market_cap_is_up`	boolean	Market cap direction
`volume_change_percent`	decimal	Volume change % for period
`volume_is_up`	boolean	Volume direction
`holders_change_percent`	decimal	Holders change % for period
`holders_change_value`	integer	Holders absolute change
`holders_is_up`	boolean	Holders direction
`historical_price`	decimal	Price at start of period
`historical_market_cap`	decimal	Market cap at start of period
`historical_volume`	decimal	Volume at start of period
`historical_holders`	integer	Holders at start of period

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