{"components":{"securitySchemes":{"builderKey":{"in":"header","name":"X-Api-Key","type":"apiKey"}}},"info":{"description":"Read-only, unauthenticated endpoints. A builder key (X-Api-Key) is optional.","title":"Cartel Family public API","version":"595e8e3"},"openapi":"3.1.0","paths":{"/api/chart/{mint}":{"get":{"operationId":"chart","parameters":[{"description":"Token address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}},{"description":"Chain id for a 0x contract.","in":"query","name":"chain","required":false,"schema":{"type":"string"}},{"description":"Timeframe (as the token page offers).","in":"query","name":"tf","required":false,"schema":{"type":"string"}},{"description":"A specific pair address.","in":"query","name":"pair","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Price history for a token: the one chart endpoint every surface draws from.","tags":["Market"]}},"/api/dexscreener/search":{"get":{"operationId":"dex_search","parameters":[{"description":"Name, ticker or address.","in":"query","name":"q","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Token search by name, ticker or address, in the full pair shape.","tags":["Market"]}},"/api/feed/trades":{"get":{"operationId":"feed_trades","parameters":[{"description":"Feed filter as the app offers (for-you, new, ...).","in":"query","name":"filter","required":false,"schema":{"type":"string"}},{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Cursor from the previous page.","in":"query","name":"before","required":false,"schema":{"type":"string"}},{"description":"Only trades in this token.","in":"query","name":"mint","required":false,"schema":{"type":"string"}},{"description":"1 to interleave launch events (For you only).","in":"query","name":"launches","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The trade feed: who bought what, how it is going, who else is in it. The unit of content of the whole product.","tags":["Social"]}},"/api/game/ladder":{"get":{"operationId":"game_ladder","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The family-rank ladder: how many members hold each rank (counts only).","tags":["Game"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/game/profile/{handle}":{"get":{"operationId":"game_profile","parameters":[{"description":"The member's handle, without @.","in":"path","name":"handle","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"One member's public game profile: rank, XP, badges.","tags":["Game"],"x-rate-limit":{"limit":120,"window_s":60}}},"/api/game/ranks":{"get":{"operationId":"game_ranks","parameters":[{"description":"Comma-separated handles.","in":"query","name":"handles","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The ranks of up to 60 handles at once.","tags":["Game"],"x-rate-limit":{"limit":120,"window_s":60}}},"/api/game/season":{"get":{"operationId":"game_season","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"This week's season race: handle, rank and score. Never a wallet, id or avatar.","tags":["Game"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/launch/launches":{"get":{"operationId":"launch_board","parameters":[{"description":"running (default) | new | trending | progress | graduated","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Rows (default 30).","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"all | ours | an outside launchpad id.","in":"query","name":"launchpad","required":false,"schema":{"type":"string"}},{"description":"all or a chain id.","in":"query","name":"chain","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The launch board: Running (tokens that clear the quality bar, the default) / New / Hot / Near graduation, ours and the outside launchpads.","tags":["Launchpad"]}},"/api/launch/status":{"get":{"operationId":"launch_status","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Which launch venues are open on which chains, and the launch fee.","tags":["Launchpad"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/launch/token/{mint}":{"get":{"operationId":"launch_token","parameters":[{"description":"The launched token's address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"One launched token: its curve, creator, graduation state and the members here who hold it.","tags":["Launchpad"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/leaderboard":{"get":{"operationId":"leaderboard","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Top traders by realised P&L in a rolling 24h window.","tags":["Social"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/leaderboard/series":{"get":{"operationId":"leaderboard_series","parameters":[{"description":"Window, e.g. 7d, 30d.","in":"query","name":"range","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The whole family's realised profit over time.","tags":["Social"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/live/members-in":{"get":{"operationId":"live_members_in","parameters":[{"description":"Comma-separated token addresses.","in":"query","name":"mints","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"How many members are in each of several tokens, with a few faces.","tags":["Platform"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/live/since":{"get":{"operationId":"live_since","parameters":[{"description":"Trade cursor from the previous answer.","in":"query","name":"trade","required":false,"schema":{"type":"integer"}},{"description":"Launch cursor.","in":"query","name":"launch","required":false,"schema":{"type":"integer"}},{"description":"Call cursor.","in":"query","name":"call","required":false,"schema":{"type":"integer"}},{"description":"Comma-separated tokens whose prices to include.","in":"query","name":"mints","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"What is new since your last call: trades, launches, calls. The first call returns the cursor only.","tags":["Platform"],"x-rate-limit":{"limit":90,"window_s":60}}},"/api/majors":{"get":{"operationId":"majors","parameters":[{"description":"Filter by symbol or name.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Candles for one asset code: with pair/tf, returns that major's OHLC instead of the list.","in":"query","name":"chain","required":false,"schema":{"type":"string"}},{"description":"Asset code for candles (with chain and tf).","in":"query","name":"pair","required":false,"schema":{"type":"string"}},{"description":"Candle timeframe for the candles form.","in":"query","name":"tf","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The majors: the large tokens of every chain (listed as their wrapped contract) with live price and 24h move.","tags":["Market"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/market/live":{"get":{"operationId":"market_live","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The live market: trending tokens across every chain, balanced per chain, with price, 24h move, liquidity and volume.","tags":["Market"]}},"/api/market/token-prices":{"get":{"operationId":"token_prices","parameters":[{"description":"Comma-separated token addresses (Solana mints or 0x contracts).","in":"query","name":"mints","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Current price and market cap for several tokens at once.","tags":["Market"],"x-rate-limit":{"limit":120,"window_s":60}}},"/api/online-count":{"get":{"operationId":"online_count","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"How many members are here right now (a heartbeat in the last 3 minutes).","tags":["Social"],"x-rate-limit":{"limit":30,"window_s":60}}},"/api/platform/landing-live":{"get":{"operationId":"landing_live","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The latest launches and recent call outcomes, public fields only.","tags":["Platform"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/platform/landing-stats":{"get":{"operationId":"landing_stats","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"All-time platform figures, as the landing page shows them.","tags":["Platform"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/pnl-card/launch/{mint}.png":{"get":{"operationId":"card_launch","parameters":[{"description":"The launched token's address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/png":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The launch card as a PNG: the one the public channel posts.","tags":["Cards & links"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/pnl-card/token/{mint}.png":{"get":{"operationId":"card_token","parameters":[{"description":"Token address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/png":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The token card as a PNG (1200x630): price, 24h move, depth, members in it, the last day's shape.","tags":["Cards & links"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/pnl-card/trader/{wallet}.png":{"get":{"operationId":"card_trader","parameters":[{"description":"The trader's wallet address.","in":"path","name":"wallet","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/png":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"A trader's P&L card as a PNG.","tags":["Cards & links"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/status/heartbeat":{"get":{"operationId":"status_heartbeat","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Platform heartbeat: ok, slow or down, for a status page.","tags":["Platform"],"x-rate-limit":{"limit":120,"window_s":60}}},"/api/token/info/{mint_address}":{"get":{"operationId":"token_info","parameters":[{"description":"Token address.","in":"path","name":"mint_address","required":true,"schema":{"type":"string"}},{"description":"Chain id for a 0x contract (see Chains); omitted means Solana.","in":"query","name":"chain","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"One token as the market sees it: name, symbol, price, liquidity, volume, pair and chain.","tags":["Market"]}},"/api/token/{mint}/candles":{"get":{"operationId":"token_candles","parameters":[{"description":"Token address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}},{"description":"Window, e.g. 1h, 24h, 7d.","in":"query","name":"range","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"OHLC candles for a token.","tags":["Market"]}},"/api/token/{mint}/family":{"get":{"operationId":"token_family","parameters":[{"description":"Token address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Members who hold this token (handles only).","tags":["Market"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/token/{mint}/trust":{"get":{"operationId":"token_trust","parameters":[{"description":"Token address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}},{"description":"Chain id.","in":"query","name":"chain","required":false,"schema":{"type":"string"}},{"description":"Pair creation time (ms) when known; sharpens the age signal.","in":"query","name":"pair_created_at","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Safety checks for a token, or \"unchecked\" when the chain has no checker.","tags":["Market"],"x-rate-limit":{"limit":30,"window_s":60}}},"/api/v1/mobile/health":{"get":{"operationId":"health","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"Platform constants: the fee in bps per leg, the chain list, minimums.","tags":["Platform"],"x-rate-limit":{"limit":60,"window_s":60}}},"/api/version":{"get":{"operationId":"version","parameters":[],"responses":{"200":{"content":{"application/json":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The running commit.","tags":["Platform"],"x-rate-limit":{"limit":120,"window_s":60}}},"/t/{mint}":{"get":{"operationId":"share_link","parameters":[{"description":"Token address.","in":"path","name":"mint","required":true,"schema":{"type":"string"}},{"description":"Chain id for a 0x contract.","in":"query","name":"chain","required":false,"schema":{"type":"string"}},{"description":"Your code.","in":"query","name":"ref","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/html":{}},"description":"OK"},"429":{"description":"Rate limited"}},"security":[{},{"builderKey":[]}],"summary":"The share link for a token: unfurls as its card and opens the token with your code attached.","tags":["Cards & links"],"x-rate-limit":{"limit":60,"window_s":60}}}},"servers":[{"url":"https://app.cartel.family"}],"tags":[{"name":"Market"},{"name":"Social"},{"name":"Game"},{"name":"Launchpad"},{"name":"Platform"},{"name":"Cards & links"}],"x-chains":[{"id":"solana","label":"Solana","min_trade_usd":2.0,"native":""},{"id":"base","label":"Base","min_trade_usd":2.0,"native":""},{"id":"bsc","label":"BNB Chain","min_trade_usd":2.0,"native":""},{"id":"arbitrum","label":"Arbitrum","min_trade_usd":2.0,"native":""},{"id":"polygon","label":"Polygon","min_trade_usd":2.0,"native":""},{"id":"robinhood","label":"Robinhood","min_trade_usd":2.0,"native":""},{"id":"ethereum","label":"Ethereum","min_trade_usd":25.0,"native":""},{"id":"monad","label":"Monad","min_trade_usd":2.0,"native":""},{"id":"hyperevm","label":"HyperEVM","min_trade_usd":2.0,"native":""}],"x-fees":{"fee_bps_per_leg":80,"fee_pct_per_leg":0.8,"launch_fee_usd":0.0,"round_trip_pct":1.6}}