Canonical listing events
curl --request GET \
--url https://www.sharpe.ai/api/v1/listings/events \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/listings/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/listings/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"event_uid": "<string>",
"exchange": "<string>",
"venue_type": "cex",
"market_type": "spot",
"event_type": "listing",
"asset_class": "token",
"instrument_id": "<string>",
"base_asset": "<string>",
"quote_asset": "<string>",
"token_symbol": "<string>",
"token_name": "<string>",
"token_coingecko_id": "<string>",
"token_contract_address": "<string>",
"token_chain": "<string>",
"narrative_slug": "<string>",
"scheduled_at": "2023-11-07T05:31:56Z",
"announced_at": "2023-11-07T05:31:56Z",
"first_trade_at": "2023-11-07T05:31:56Z",
"first_seen_at": "2023-11-07T05:31:56Z",
"effective_at": "2023-11-07T05:31:56Z",
"status": "announced",
"source_kind": "official_api",
"source_confidence": "authoritative",
"source_url": "<string>",
"id": 123,
"exchange_name": "<string>",
"raw_payload": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"count": 123,
"next_cursor": "<string>",
"window_days": 123,
"generated_at": "2023-11-07T05:31:56Z",
"last_updated_at": "2023-11-07T05:31:56Z",
"partial": true,
"provider_coverage": [
{
"provider": "<string>",
"kind": "database",
"status": "ok",
"row_count": 1,
"last_observed_at": "2023-11-07T05:31:56Z"
}
],
"source": "events",
"partial_reasons": [
"<string>"
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f6g7h8i9j0",
"timestamp": "2023-11-07T05:31:56Z",
"elapsed_ms": 1,
"dataset_id": "funding_rates_current",
"as_of": "2023-11-07T05:31:56Z",
"stale_after": "2023-11-07T05:31:56Z",
"freshness_sla_seconds": 123,
"freshness_status": "fresh",
"runtime_status": "ok",
"served_from": "snapshot",
"generated_at": "2023-11-07T05:31:56Z",
"source": [
"<string>"
],
"coverage": {
"expected": 123,
"used": 123,
"dropped": {},
"missing": [
"<string>"
]
},
"warnings": [
"<string>"
],
"truncated": true
}
}New Listings
Canonical listing events
Returns canonical listing lifecycle events across CEXs and Perp DEXs, including Spot listings, Perp listings, delistings, suspensions, resumptions, scheduled trading starts, source URLs, source confidence, source-observation freshness, and per-provider health. The opaque cursor advances the persisted database and official live-overlay streams independently so either source can fill a page without stranding the other.
GET
/
v1
/
listings
/
events
Canonical listing events
curl --request GET \
--url https://www.sharpe.ai/api/v1/listings/events \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/listings/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/listings/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"event_uid": "<string>",
"exchange": "<string>",
"venue_type": "cex",
"market_type": "spot",
"event_type": "listing",
"asset_class": "token",
"instrument_id": "<string>",
"base_asset": "<string>",
"quote_asset": "<string>",
"token_symbol": "<string>",
"token_name": "<string>",
"token_coingecko_id": "<string>",
"token_contract_address": "<string>",
"token_chain": "<string>",
"narrative_slug": "<string>",
"scheduled_at": "2023-11-07T05:31:56Z",
"announced_at": "2023-11-07T05:31:56Z",
"first_trade_at": "2023-11-07T05:31:56Z",
"first_seen_at": "2023-11-07T05:31:56Z",
"effective_at": "2023-11-07T05:31:56Z",
"status": "announced",
"source_kind": "official_api",
"source_confidence": "authoritative",
"source_url": "<string>",
"id": 123,
"exchange_name": "<string>",
"raw_payload": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"count": 123,
"next_cursor": "<string>",
"window_days": 123,
"generated_at": "2023-11-07T05:31:56Z",
"last_updated_at": "2023-11-07T05:31:56Z",
"partial": true,
"provider_coverage": [
{
"provider": "<string>",
"kind": "database",
"status": "ok",
"row_count": 1,
"last_observed_at": "2023-11-07T05:31:56Z"
}
],
"source": "events",
"partial_reasons": [
"<string>"
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f6g7h8i9j0",
"timestamp": "2023-11-07T05:31:56Z",
"elapsed_ms": 1,
"dataset_id": "funding_rates_current",
"as_of": "2023-11-07T05:31:56Z",
"stale_after": "2023-11-07T05:31:56Z",
"freshness_sla_seconds": 123,
"freshness_status": "fresh",
"runtime_status": "ok",
"served_from": "snapshot",
"generated_at": "2023-11-07T05:31:56Z",
"source": [
"<string>"
],
"coverage": {
"expected": 123,
"used": 123,
"dropped": {},
"missing": [
"<string>"
]
},
"warnings": [
"<string>"
],
"truncated": true
}
}Authorizations
BearerAuthApiKeyAuth
Query Parameters
Filter to a single exchange or perp DEX.
Available options:
binance, okx, bybit, gateio, mexc, bitget, kucoin, bingx, bitmart, deepcoin, coinbase, kraken, crypto_com, upbit, bithumb, htx, bitfinex, bitstamp, gemini, bitmex, deribit, phemex, lbank, bitrue, coinex, backpack, hashkey, whitebit, toobit, hyperliquid, aster, dydx, aevo 
