API Reference

api.superhero.com is the read API behind Superhero: tokens and their prices, posts and topics, accounts and portfolios, the DEX, trending and analytics. Reads need no credential. Writes are authorised by a wallet signature over a server-issued challenge, not by an API key.

curl -s "https://api.superhero.com/api/tokens?order_by=trending_score&order_direction=DESC&limit=5"

Start with Conventions. Pagination, units, errors, rate limits and the write flow are shared by every endpoint and are not repeated per page.

Base URLs

Network	Base URL	Chain id
Mainnet	`https://api.superhero.com`	`ae_mainnet`
Testnet	Not publicly documented	`ae_uat`

Both hosts serve identical paths. Every path begins with /api/.

Sections

Page	Covers
Conventions	Pagination, shared query parameters, units, errors, rate limits, CORS, authentication
Posts	The feed, single posts, comments, topics, tips and the combined activity feed
Tokens	The full `TokenDto`, holders, history, performance and rankings
Accounts	Account records, holdings, portfolio value, PnL and the leaderboard
Transactions	Buys and sells, by token, by account or by hash
Trending & Topics	Scored tags, topics, the trending-score formula and unified search
Analytics	Platform aggregates and AE fiat rates
Profile	Profile reads and every signature-authorised write endpoint
Factory & Contracts	The live factory, its collections and their naming rules
Invitations & Affiliations	Invite claim status and referral analytics
DEX	AMM tokens, pairs, routes and swap transactions
WebSocket	The two Socket.IO events that push live token data, and the notification namespace
Node & Middleware	Direct chain access when the REST API is not enough

Endpoint index

Tokens

GET  /api/tokens
GET  /api/tokens/{address}
GET  /api/tokens/{address}/holders
GET  /api/tokens/{address}/rankings
GET  /api/tokens/{address}/history
GET  /api/tokens/{address}/transactions
GET  /api/tokens/{address}/performance
GET  /api/tokens/{address}/performance-raw
GET  /api/tokens/{address}/score
GET  /api/tokens/{address}/trending-eligibility
GET  /api/tokens/preview/{address}
GET  /api/tokens/preview/{address}/sparkline.svg

Accounts

GET  /api/accounts
GET  /api/accounts/{address}
GET  /api/accounts/search
GET  /api/accounts/chain-names
GET  /api/accounts/by-nostr
GET  /api/accounts/{address}/tokens
GET  /api/accounts/{address}/portfolio/history
GET  /api/accounts/{address}/portfolio/tokens/history
GET  /api/accounts/{address}/portfolio/value
GET  /api/accounts/{address}/portfolio/stats
GET  /api/accounts/{address}/portfolio/pnl-chart.svg
GET  /api/accounts/{address}/pnl
GET  /api/accounts/leaderboard

Transactions

GET  /api/transactions
GET  /api/transactions/by-hash
GET  /api/debug/failed-transactions

Posts, topics and tips

GET  /api/posts
GET  /api/posts/popular
GET  /api/posts/{id}
GET  /api/posts/{id}/comments
GET  /api/feed
GET  /api/topics
GET  /api/topics/{id}
GET  /api/topics/name/{name}
GET  /api/topics/popular/trending
GET  /api/tips
GET  /api/tips/posts/{postId}/summary
GET  /api/tips/accounts/{address}/summary
GET  /api/search
GET  /api/giphy/search
GET  /api/announcements

Trending tags

GET  /api/trending-tags
GET  /api/trending-tags/{tag}
POST /api/trending-tags                               (API key required)

Analytics

GET  /api/analytics/past-24-hours
GET  /api/analytics
GET  /api/analytics/summary
GET  /api/analytics/preview
GET  /api/analytics/daily-trade-volume
GET  /api/analytics/daily-unique-active-users
GET  /api/analytics/daily-created-tokens-count
GET  /api/analytics/daily-market-cap-sum
GET  /api/analytics/total-market-cap
GET  /api/analytics/total-created-tokens
GET  /api/analytics/total-unique-users
GET  /api/analytics/challenge
GET  /api/analytics/challenge/preview
GET  /api/posts/analytics
GET  /api/posts/analytics/past-24-hours
GET  /api/posts/analytics/top-posters
GET  /api/posts/analytics/top-topics
GET  /api/posts/analytics/preview
GET  /api/coins/aeternity/rates
GET  /api/coins/aeternity/history
GET  /api/coins/aeternity/market-data

Profile, identity and rewards

GET   /api/profile/{address}
GET   /api/profile                                    (batch)
GET   /api/profile/feed
POST  /api/address-links/x/claim
POST  /api/address-links/x/submit
POST  /api/address-links/x/unclaim
POST  /api/address-links/x/unclaim/submit
POST  /api/address-links/bio/claim
POST  /api/address-links/bio/submit
POST  /api/address-links/bio/unclaim
POST  /api/address-links/bio/unclaim/submit
POST  /api/address-links/site/claim
POST  /api/address-links/site/submit
POST  /api/address-links/site/unclaim
POST  /api/address-links/site/unclaim/submit
POST  /api/address-links/prefered-aens-name/claim
POST  /api/address-links/prefered-aens-name/submit
POST  /api/address-links/prefered-aens-name/unclaim
POST  /api/address-links/prefered-aens-name/unclaim/submit
POST  /api/address-links/nostr/claim
POST  /api/address-links/nostr/submit
POST  /api/address-links/nostr/unclaim
POST  /api/address-links/nostr/unclaim/submit
GET   /api/profile/chain-name/sponsorship/{name}
POST  /api/profile/chain-name/challenge
POST  /api/profile/chain-name/claim
GET   /api/profile/{address}/chain-name-claim
GET   /api/profile/{address}/x-posting-reward
POST  /api/profile/x-posting-reward/recheck-challenge
POST  /api/profile/{address}/x-posting-reward/recheck
POST  /api/profile/{address}/x-reward/referral-link
POST  /api/profile/{address}/challenge                (deprecated)
PATCH /api/profile/{address}                          (deprecated)

Factory, invitations and affiliations

GET  /api/factory
GET  /api/contracts                                   (deprecated)
GET  /api/stats
GET  /api/invitations
GET  /api/affiliations/invites/{code}
POST /api/affiliations
POST /api/affiliations/invites/{code}/{provider}/{access_code}
GET  /api/affiliations/preview
GET  /api/bcl-affiliation/analytics
GET  /api/bcl-affiliation/analytics/top-inviters
GET  /api/bcl-affiliation/analytics/x-verification
GET  /api/bcl-affiliation/analytics/x-invite
GET  /api/bcl-affiliation/tree

DEX

GET   /api/dex/tokens
GET   /api/dex/tokens/{address}
GET   /api/dex/tokens/{address}/price
GET   /api/dex/tokens/{address}/price/analysis
GET   /api/dex/tokens/{address}/summary
GET   /api/dex/tokens/{address}/history
PATCH /api/dex/tokens/{address}/listed                (API key required)
GET   /api/dex/pairs
GET   /api/dex/pairs/{address}
GET   /api/dex/pairs/{address}/history
GET   /api/dex/pairs/{address}/summary
GET   /api/dex/pairs/{address}/preview
GET   /api/dex/pairs/from/{from_token}/to/{to_token}
GET   /api/dex/pairs/from/{from_token}/to/{to_token}/providers
GET   /api/dex/transactions
GET   /api/dex/transactions/{txHash}
GET   /api/dex/transactions/pair/{pairAddress}
GET   /api/dex/swap-routes/{from_token}/{to_token}

Governance, chat rooms and notifications

GET    /api/governance/votes
GET    /api/governance/votes/{pollAddress}
GET    /api/governance/delegations
GET    /api/governance/delegations/{accountAddress}
GET    /api/rooms
GET    /api/rooms/config
GET    /api/rooms/{saleAddress}/members
GET    /api/rooms/{saleAddress}/mute
POST   /api/rooms/{saleAddress}/mute
POST   /api/rooms/{saleAddress}/mute/challenge
POST   /api/rooms/{saleAddress}/recheck
GET    /api/tgr/metrics
POST   /api/notifications/devices/challenge
POST   /api/notifications/devices
DELETE /api/notifications/devices
POST   /api/notifications/preferences/challenge
GET    /api/notifications/{address}/preferences
POST   /api/notifications/{address}/preferences

The notification feed routes are the only bearer-authenticated part of the API:

POST /api/notifications/{address}/feed/challenge
POST /api/notifications/{address}/feed/session
GET  /api/notifications/{address}/feed
GET  /api/notifications/{address}/feed/unread-count
POST /api/notifications/{address}/feed/read
POST /api/notifications/{address}/web-push/subscription
GET  /api/notifications/web-push/vapid-public-key

Governance is documented under Governance, chat rooms under Chat and notifications under Notifications.

Middleware mirror

GET /api/mdw/health
GET /api/v2/mdw/txs
GET /api/v2/mdw/txs/{hash}
GET /api/v2/mdw/key-blocks
GET /api/v2/mdw/key-blocks/{hash}
GET /api/v2/mdw/micro-blocks
GET /api/v2/mdw/micro-blocks/{hash}
GET /api/v2/mdw/sync-state
GET /api/v2/mdw/plugin-sync-state

Operator

GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD  /api/bull-board
GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD  /api/bull-board/{path}

The job-queue dashboard. Not part of the public surface.

Conventions: read before any endpoint page
Tokens: the most-used part of the API
Node & Middleware: when the REST API does not have the data
Agent quickstart: from these endpoints to a working agent
æternity node API documentation (opens in a new tab): the chain-level API underneath

CLI Reference Conventions