{"uid":"cap_F0tc_lUnkLmM9dnxZ2SRQ","slug":"cryptyx-custom-composite-ranker-7a103e81","name":"Cryptyx Custom Composite Ranker","description":"","url":"https://www.cryptyx.ai/api/signals/composite/custom","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["weights"],"properties":{"day":{"type":"string","description":"Optional anchor day, YYYY-MM-DD. Defaults to MAX(asof_day) in signals.class_composite_log."},"horizon":{"type":"string","description":"Composite horizon: 7d | 14d | 30d. Default 7d."},"weights":{"type":"object","description":"Custom weight per factor class. Required keys: CORR, EFF, FLOW, FUT, OB, OPT, TR, VOL. Each value 0-2. Weights are normalised by sum of absolute values, not required to sum to 1."},"threshold":{"type":"number","description":"Optional |score| floor — assets with |custom score| < threshold are excluded from assets[] (top_movers and summary still computed against the full ranked set)."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"application/json","example":{"rankings":[{"rank":1,"asset":"BTC","custom_score":0.55}],"weights_applied":{"TR":0.3,"VOL":0.2}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__wuRMJXndbUUw_Gj50KqA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Re-ranks the full ~200-asset crypto universe using caller-supplied factor class weights to produce a custom composite score ranking.","exampleAgentPrompt":"Rank the full crypto universe for a 30-day horizon using my custom weights: put 40% on trend, 25% on volatility, 15% on momentum, 10% on liquidity, and 10% on sentiment — make sure the weights sum to 1.","exampleUseCases":null,"resultDescription":"Returns a ranked list of ~200 crypto assets sorted by custom composite score (rank, asset ticker, custom_score), plus a confirmation of the weights actually applied across factor classes.","failureModes":["Weights do not sum to 1.0 — returns 400 validation error","Invalid factor class key in weights object — returns 400 with unrecognized key message","Unsupported horizon value (not 7d/14d/30d) — returns 400 enum error","Missing required weights or horizon field — returns 422 unprocessable entity","Payment not provided or insufficient — returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need to impose a specific institutional view or custom factor allocation on the full crypto ranking, rather than relying on Cryptyx's default composite. Ideal for A/B testing alternative weighting recipes, backtesting a house model, or generating a bespoke ranked universe for portfolio construction. Prefer this over the default composite endpoint whenever factor weights need to deviate from the platform default.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:27.279Z","isFirstParty":false}