OpenAPI Specification

The CONYR API is fully described by an OpenAPI 3.1 specification.

Download

curl -O https://docs.conyr.ai/openapi.yaml

Spec covers the full live surface. The hosted openapi.yaml now documents every implemented /v1 route — holders, bundles, coordination v2, intel composites, funding abuse, buyer quality, profile/similar/provenance, entanglement, wash trades, and suspicious activity — each carrying an x-tier extension declaring its minimum access tier. The only operations still absent are the coming-soon ones (price, pnl, unrealized-pnl, webhooks, bulk).

Spec Details

Version: OpenAPI 3.1.0
Auth: HTTP Bearer (securitySchemes.BearerAuth)
WebSocket: Documented as component schemas (WsClientMessage, WsServerMessage, WsChannelFormat)

Tag	Description
Wallets	Performance, trades, positions, labels, quality, profile, similarity, provenance
Leaderboard	Ranked wallet leaderboards by PnL, ROI, or win rate
Tokens	Token info, OHLCV candles, trades, holders, bundles, and security signals
Coordination	coordination-v2 follows, entities, campaigns, crowd state, and health
Intel	Cross-cutting coordination intelligence composites
Operations	Health, readiness, Prometheus metrics

Operation IDs (current spec)

These operations are present in the live spec and stable:

getHealth
getReadiness
getMetrics
getWalletPerformance
getWalletTrades
getWalletPositions
getWalletLabels
getWalletQuality
getWalletProfile
getWalletSimilar
getWalletProvenance
getWalletEntanglement
getWalletFollows
getWalletEntity
getLeaderboard
getTokenInfo
getTokenOhlcv
getTokenTrades
getTokenHoldersSummary
getTokenHoldersTop
getTokenHolders
getBuyerQuality
getTokenBundleSummary
getTokenBundles
getBundleDetail
getWashTrades
getFundingAbuse
getSuspiciousActivity
getTokenCampaigns
getTokenCrowd
getEntityDetail
getEntityMembers
getCoordinationHealth
getFormingCoordinatedPushes
getFollowerCascade
getEmergingEntities
getTokenEarlyBuyers
getTokenCopyOriginator
getTokenEntityConcentration
getTokenLateRetail

Coming soon (not yet in spec)

These endpoints are on the roadmap and are intentionally absent from openapi.yaml. They are not live yet:

getTokenPrice               — token price
getWalletPnl                — realized PnL summary
getWalletUnrealizedPnl      — workaround: positions + ohlcv?timeframe=1s
postWebhooks                — webhook registration (Enterprise)
postBulkWalletProfile       — bulk wallet profiles (Enterprise)
postBulkWalletCoordination  — bulk wallet coordination (Enterprise)

Removed (no longer on the API)

getWalletTaxonomy       — superseded by getWalletLabels
getWalletBundles        — superseded by token-scoped getTokenBundles
getWalletSecurity       — wallet-scoped REST never shipped; use WS wallet:{addr}:security

MCP Server Endpoint Reference