z100 Posts Endpoint - zSignals API

Endpoint

GET /v1/z100/posts

Live Example Response

LIVE DATA

Updated every minute

[
  {
    "rank": 1,
    "symbol": "Base is for everyone",
    "name": "Base is for everyone",
    "creator_name": "base",
    "creator_address": "0x19ff7ea0badffa183f03533c3884f9ca03145aad",
    "market_cap": "$2.1M",
    "market_cap_raw": 2128407.14,
    "volume_24h": "$7.0K",
    "total_volume": "$120.2M",
    "unique_holders": 78986,
    "change_24h": "-3.3%"
  },
  {
    "rank": 2,
    "symbol": "Aura",
    "name": "Aura",
    "creator_name": "imagineclub",
    "creator_address": "0x000061aa55a092c8e9844dd226a9a3c9fa231822",
    "market_cap": "$1.2M",
    "market_cap_raw": 1156825.52,
    "volume_24h": "$1.85",
    "total_volume": "$9.8M",
    "unique_holders": 16,
    "change_24h": "+0.0%"
  },
  {
    "rank": 3,
    "symbol": "中",
    "name": "中",
    "creator_name": "basezhong.base.eth",
    "creator_address": "0x798e38a04219bee0d304cfc97bb9f2016dbc24c4",
    "market_cap": "$946.5K",
    "market_cap_raw": 946479.16,
    "volume_24h": "$9.0K",
    "total_volume": "$2.1M",
    "unique_holders": 20464,
    "change_24h": "+20.0%"
  }
]

Request Examples

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

const response = await fetch('https://api.zsignals.xyz/v1/z100/posts', {
  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/posts',
    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/posts')
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/posts?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
`symbol`	string	Post token symbol
`name`	string	Post title or name
`creator_name`	string	Creator of the post
`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"
    }
  }
}