{ "openapi": "3.1.0", "info": { "title": "Orus Partner Scan API", "version": "1.0.2", "description": "Official Orus observations on Robinhood Chain mainnet (4663), organized by subject: token, market, security, risk and agent activity. Testnet (46630) is not supported. Whitelisted partners only. Null means unknown. USD money values, percentage points, seconds and UTC timestamps. No safety guarantee or trading instruction.", "contact": { "name": "Orus on X", "url": "https://x.com/Orus_agent" } }, "servers": [ { "url": "https://www.orusagent.xyz" } ], "security": [ { "PartnerKey": [] } ], "paths": { "/api/v1/scan": { "get": { "operationId": "scanToken", "summary": "Scan a token on Robinhood Chain", "description": "Orus observations grouped by subject: token, market, security, risk, agents and other indicators. Details are required; optional chart/launch/agent activity failures return 200 with explicit unavailable fields. Agent activity is always included, even with include=none. Authentication and shared partner quotas apply before validation or cache access. Use include=none for Telegram cards.", "parameters": [ { "name": "chainId", "in": "query", "required": true, "description": "Robinhood Chain mainnet (4663) only. Testnet (46630) returns 400 unsupported_chain. Never relabel a testnet contract as mainnet.", "schema": { "type": "integer", "enum": [ 4663 ] } }, { "name": "token", "in": "query", "required": true, "description": "Non-zero EVM contract address. Normalized to lowercase.", "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, { "name": "include", "in": "query", "description": "Optional chart and launch reads. Core data and agents are always included.", "schema": { "type": "string", "enum": [ "none", "chart", "launch", "chart,launch", "launch,chart" ], "default": "chart" } }, { "name": "dipThresholdPct", "in": "query", "description": "Percent decline from ATH that defines a dip. Used when chart is included.", "schema": { "type": "number", "minimum": 1, "maximum": 99, "default": 30 } }, { "name": "lookbackHours", "in": "query", "description": "Hours of five-minute candle history. Used when chart is included; does not change the fixed 24h agent window.", "schema": { "type": "number", "minimum": 1, "maximum": 168, "default": 48 } } ], "responses": { "200": { "description": "Token scan; inspect per-section availability and warnings.", "headers": { "X-Request-Id": { "description": "Support correlation ID", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Partner minute quota", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining admitted calls this minute", "schema": { "type": "string" } }, "X-RateLimit-Day-Remaining": { "description": "Remaining admitted calls this UTC day", "schema": { "type": "string" } }, "Cache-Control": { "description": "private, no-store", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenScan" } } } }, "400": { "description": "Invalid parameters or unsupported chain", "headers": { "X-Request-Id": { "description": "Support correlation ID", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid, revoked, expired or inactive partner credential", "headers": { "X-Request-Id": { "description": "Support correlation ID", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Token not indexed", "headers": { "X-Request-Id": { "description": "Support correlation ID", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Method not allowed" }, "429": { "description": "Partner quota exceeded; honor Retry-After", "headers": { "X-Request-Id": { "description": "Support correlation ID", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds before retry", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Scan temporarily unavailable; bounded retry", "headers": { "X-Request-Id": { "description": "Support correlation ID", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds before retry", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "PartnerKey": { "type": "http", "scheme": "bearer", "bearerFormat": "orus_pk_<64 lowercase hexadecimal characters>" } }, "schemas": { "TokenScan": { "type": "object", "required": [ "apiVersion", "requestId", "chainId", "checkedAt", "cache", "token", "market", "pool", "security", "risk", "ath", "atl", "dip", "launch", "deployer", "socials", "agents", "availability", "warnings", "attribution", "card" ], "properties": { "apiVersion": { "type": "string", "const": "1.0" }, "requestId": { "type": "string", "format": "uuid" }, "chainId": { "type": "integer", "const": 4663 }, "checkedAt": { "type": "string", "format": "date-time", "description": "Collection start; not the quote timestamp." }, "cache": { "type": "object", "required": [ "hit", "ageSeconds", "maxAgeSeconds" ], "properties": { "hit": { "type": "boolean" }, "ageSeconds": { "type": "integer", "minimum": 0 }, "maxAgeSeconds": { "type": "integer", "const": 30 } } }, "token": { "type": "object", "required": [ "address", "name", "symbol", "image", "createdAt", "decimals", "ageSeconds", "totalSupply", "circulatingSupply" ], "properties": { "address": { "type": "string", "pattern": "^0x[0-9a-f]{40}$" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ], "description": "Public image URL, or null when the image cannot be published." }, "createdAt": { "type": [ "string", "null" ], "format": "date-time" }, "decimals": { "type": [ "number", "null" ] }, "ageSeconds": { "type": [ "number", "null" ] }, "totalSupply": { "type": [ "number", "null" ] }, "circulatingSupply": { "type": [ "number", "null" ] } } }, "market": { "type": "object", "required": [ "priceUsd", "marketCapUsd", "fdvUsd", "liquidityUsd", "maxLiquidityUsd", "liquidityToMarketCapPct", "volumeChange5mPct", "totalFeesUsd", "secondsSinceLastTrade", "latestTradeAt", "priceUpdatedAt", "windows" ], "properties": { "priceUsd": { "type": [ "number", "null" ] }, "marketCapUsd": { "type": [ "number", "null" ] }, "fdvUsd": { "type": [ "number", "null" ] }, "liquidityUsd": { "type": [ "number", "null" ] }, "maxLiquidityUsd": { "type": [ "number", "null" ] }, "liquidityToMarketCapPct": { "type": [ "number", "null" ] }, "volumeChange5mPct": { "type": [ "number", "null" ] }, "totalFeesUsd": { "type": [ "number", "null" ] }, "secondsSinceLastTrade": { "type": [ "number", "null" ] }, "latestTradeAt": { "type": [ "string", "null" ], "format": "date-time" }, "priceUpdatedAt": { "type": "null", "description": "Exact quote timestamp is unavailable; latestTradeAt is separate." }, "windows": { "type": "object", "required": [ "1m", "5m", "15m", "1h", "4h", "6h", "12h", "24h" ], "properties": { "1m": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "5m": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "15m": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "1h": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "4h": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "6h": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "12h": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } }, "24h": { "type": "object", "required": [ "volumeUsd", "buyVolumeUsd", "sellVolumeUsd", "organicVolumeUsd", "organicBuyVolumeUsd", "organicSellVolumeUsd", "buys", "sells", "trades", "buyers", "sellers", "traders", "organicTrades", "organicTraders", "feesUsd", "priceChangePct" ], "properties": { "volumeUsd": { "type": [ "number", "null" ] }, "buyVolumeUsd": { "type": [ "number", "null" ] }, "sellVolumeUsd": { "type": [ "number", "null" ] }, "organicVolumeUsd": { "type": [ "number", "null" ] }, "organicBuyVolumeUsd": { "type": [ "number", "null" ] }, "organicSellVolumeUsd": { "type": [ "number", "null" ] }, "buys": { "type": [ "number", "null" ] }, "sells": { "type": [ "number", "null" ] }, "trades": { "type": [ "number", "null" ] }, "buyers": { "type": [ "number", "null" ] }, "sellers": { "type": [ "number", "null" ] }, "traders": { "type": [ "number", "null" ] }, "organicTrades": { "type": [ "number", "null" ] }, "organicTraders": { "type": [ "number", "null" ] }, "feesUsd": { "type": [ "number", "null" ] }, "priceChangePct": { "type": [ "number", "null" ] } } } } } } }, "pool": { "type": "object", "required": [ "address", "dex", "dexKey", "launchpad", "factory", "bonded", "bondingPct", "bondedAt", "bondingCurveAddress", "launchpadUrl" ], "properties": { "address": { "type": [ "string", "null" ] }, "dex": { "type": [ "string", "null" ] }, "dexKey": { "type": [ "string", "null" ] }, "launchpad": { "type": [ "string", "null" ] }, "factory": { "type": [ "string", "null" ] }, "bonded": { "type": [ "boolean", "null" ] }, "bondingPct": { "type": [ "number", "null" ] }, "bondedAt": { "type": [ "string", "null" ], "format": "date-time" }, "bondingCurveAddress": { "type": [ "string", "null" ] }, "launchpadUrl": { "type": [ "string", "null" ] } } }, "security": { "type": "object", "required": [ "isHoneypot", "isProxy", "buyTaxPct", "sellTaxPct", "liquidityBurnPct" ], "properties": { "isHoneypot": { "type": [ "boolean", "null" ], "description": "Reported honeypot flag; null is unknown. false is not a safety guarantee or an execution simulation." }, "isProxy": { "type": [ "boolean", "null" ], "description": "Reported proxy-contract flag; null is unknown." }, "buyTaxPct": { "type": [ "number", "null" ], "description": "Reported token buy tax in percent: 1 means 1%. Excludes pool fees, hook fees, slippage and gas. null is unknown." }, "sellTaxPct": { "type": [ "number", "null" ], "description": "Reported token sell tax in percent: 1 means 1%. Excludes pool fees, hook fees, slippage and gas. null is unknown." }, "liquidityBurnPct": { "type": [ "number", "null" ], "description": "Reported liquidity burn percentage; null is unknown. Independent of honeypot and tax coverage." } } }, "risk": { "type": "object", "required": [ "bundlersPct", "snipersPct", "insidersPct", "devHoldingsPct", "top10Pct", "top50Pct", "top100Pct", "top200Pct", "freshTradersPct", "proTradersPct", "smartTradersPct", "holdersCount", "bundlersCount", "snipersCount", "insidersCount", "laggedFields" ], "properties": { "bundlersPct": { "type": [ "number", "null" ] }, "snipersPct": { "type": [ "number", "null" ] }, "insidersPct": { "type": [ "number", "null" ] }, "devHoldingsPct": { "type": [ "number", "null" ] }, "top10Pct": { "type": [ "number", "null" ] }, "top50Pct": { "type": [ "number", "null" ] }, "top100Pct": { "type": [ "number", "null" ] }, "top200Pct": { "type": [ "number", "null" ] }, "freshTradersPct": { "type": [ "number", "null" ] }, "proTradersPct": { "type": [ "number", "null" ] }, "smartTradersPct": { "type": [ "number", "null" ] }, "holdersCount": { "type": [ "number", "null" ] }, "bundlersCount": { "type": [ "number", "null" ] }, "snipersCount": { "type": [ "number", "null" ] }, "insidersCount": { "type": [ "number", "null" ] }, "laggedFields": { "type": "array", "items": { "type": "string" } } } }, "ath": { "type": "object", "required": [ "priceUsd", "ageSeconds", "marketCapUsd", "changeFromAthPct", "drawdownPct", "at", "supplyBasis" ], "properties": { "priceUsd": { "type": [ "number", "null" ] }, "ageSeconds": { "type": [ "number", "null" ] }, "marketCapUsd": { "type": [ "number", "null" ] }, "changeFromAthPct": { "type": [ "number", "null" ] }, "drawdownPct": { "type": [ "number", "null" ] }, "at": { "type": [ "string", "null" ], "format": "date-time" }, "supplyBasis": { "type": "string", "const": "current_supply" } } }, "atl": { "type": "object", "required": [ "priceUsd", "at" ], "properties": { "priceUsd": { "type": [ "number", "null" ] }, "at": { "type": [ "string", "null" ], "format": "date-time" } } }, "dip": { "type": [ "object", "null" ], "required": [ "thresholdPct", "thresholdPriceUsd", "firstDipAgeSeconds", "athToFirstDipSeconds", "secondsSinceLastObservedDip", "requestedLookbackHours", "candleCount", "lastCandleAgeSeconds", "windowLowUsd", "windowHighUsd", "reboundFromWindowLowPct", "isCurrentlyBelowThreshold", "firstDipAt", "lastObservedDipAt", "windowStart", "windowEnd", "historyStatus", "hasGaps", "interval" ], "properties": { "thresholdPct": { "type": [ "number", "null" ] }, "thresholdPriceUsd": { "type": [ "number", "null" ] }, "firstDipAgeSeconds": { "type": [ "number", "null" ] }, "athToFirstDipSeconds": { "type": [ "number", "null" ] }, "secondsSinceLastObservedDip": { "type": [ "number", "null" ] }, "requestedLookbackHours": { "type": [ "number", "null" ] }, "candleCount": { "type": [ "number", "null" ] }, "lastCandleAgeSeconds": { "type": [ "number", "null" ] }, "windowLowUsd": { "type": [ "number", "null" ] }, "windowHighUsd": { "type": [ "number", "null" ] }, "reboundFromWindowLowPct": { "type": [ "number", "null" ] }, "isCurrentlyBelowThreshold": { "type": [ "boolean", "null" ] }, "firstDipAt": { "type": [ "string", "null" ], "format": "date-time" }, "lastObservedDipAt": { "type": [ "string", "null" ], "format": "date-time" }, "windowStart": { "type": [ "string", "null" ], "format": "date-time" }, "windowEnd": { "type": [ "string", "null" ], "format": "date-time" }, "historyStatus": { "type": "string", "enum": [ "unavailable", "partial", "covers_ath" ] }, "hasGaps": { "type": "boolean" }, "interval": { "type": "string", "const": "5m" } } }, "launch": { "type": [ "object", "null" ], "required": [ "firstTradeAt", "sampleWindowSeconds", "priceUsd", "marketCapUsd", "sampledTrades", "supplyBasis", "mayBeTruncated" ], "properties": { "firstTradeAt": { "type": [ "string", "null" ], "format": "date-time" }, "sampleWindowSeconds": { "type": [ "number", "null" ] }, "priceUsd": { "type": [ "number", "null" ] }, "marketCapUsd": { "type": [ "number", "null" ] }, "sampledTrades": { "type": [ "number", "null" ] }, "supplyBasis": { "type": "string", "const": "current_supply" }, "mayBeTruncated": { "type": "boolean" } } }, "deployer": { "type": "object", "required": [ "status", "address", "launches", "migrations", "rugs", "reason" ], "properties": { "status": { "type": "string", "enum": [ "partial", "unavailable" ] }, "address": { "type": [ "string", "null" ] }, "launches": { "type": [ "number", "null" ] }, "migrations": { "type": [ "number", "null" ] }, "rugs": { "type": "null" }, "reason": { "type": "string" } } }, "socials": { "type": "object", "required": [ "website", "twitter", "telegram", "discord", "description" ], "properties": { "website": { "type": [ "string", "null" ] }, "twitter": { "type": [ "string", "null" ] }, "telegram": { "type": [ "string", "null" ] }, "discord": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] } } }, "agents": { "type": "object", "required": [ "status", "scope", "coverage", "asOf", "windowHours", "real", "simulation" ], "properties": { "status": { "type": "string", "enum": [ "available", "unavailable" ] }, "scope": { "type": "string", "const": "all_orus_agents", "description": "Desk and customer agents on the requested chain, regardless of current agent status or mode. Aggregates only." }, "coverage": { "type": "string", "const": "retained_history", "description": "Current retained positions, not guaranteed lifetime history. Real entries require a non-empty recorded entry_tx; entry_pending is excluded. Mode is determined by position status, not current agent settings." }, "asOf": { "type": [ "string", "null" ], "format": "date-time", "description": "Observation timestamp for agent activity; null if unavailable. Cached with the scan for at most 30 seconds from checkedAt." }, "windowHours": { "type": "integer", "const": 24 }, "real": { "type": "object", "required": [ "tradedAgents", "holdingAgents", "entries24h", "exits24h", "lastEntryAt", "lastExitAt" ], "properties": { "tradedAgents": { "type": [ "integer", "null" ], "minimum": 0, "description": "Distinct agents with eligible entries in retained history, including agents currently holding. Not a count of trades or independent strategies." }, "holdingAgents": { "type": [ "integer", "null" ], "minimum": 0, "description": "Distinct agents with open positions in the recorded book. Real includes sell_failed, including paused/stopped agents. No on-chain balance verification." }, "entries24h": { "type": [ "integer", "null" ], "minimum": 0, "description": "Eligible position entries in [asOf - 24h, asOf]. Counts positions, not distinct agents; uses recorded entry_at." }, "exits24h": { "type": [ "integer", "null" ], "minimum": 0, "description": "Position closures in [asOf - 24h, asOf], using exit_at and closed status. Includes simulated write-offs; not proof of a successful on-chain sale." }, "lastEntryAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Latest eligible recorded entry_at in retained history, or null if none." }, "lastExitAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Latest recorded exit_at of a closed eligible position, or null if none. Failed exits are excluded." } } }, "simulation": { "type": "object", "required": [ "tradedAgents", "holdingAgents", "entries24h", "exits24h", "lastEntryAt", "lastExitAt" ], "properties": { "tradedAgents": { "type": [ "integer", "null" ], "minimum": 0, "description": "Distinct agents with eligible entries in retained history, including agents currently holding. Not a count of trades or independent strategies." }, "holdingAgents": { "type": [ "integer", "null" ], "minimum": 0, "description": "Distinct agents with open positions in the recorded book. Real includes sell_failed, including paused/stopped agents. No on-chain balance verification." }, "entries24h": { "type": [ "integer", "null" ], "minimum": 0, "description": "Eligible position entries in [asOf - 24h, asOf]. Counts positions, not distinct agents; uses recorded entry_at." }, "exits24h": { "type": [ "integer", "null" ], "minimum": 0, "description": "Position closures in [asOf - 24h, asOf], using exit_at and closed status. Includes simulated write-offs; not proof of a successful on-chain sale." }, "lastEntryAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Latest eligible recorded entry_at in retained history, or null if none." }, "lastExitAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Latest recorded exit_at of a closed eligible position, or null if none. Failed exits are excluded." } } } } }, "availability": { "type": "object", "required": [ "details", "chart", "launch", "agents", "security" ], "properties": { "details": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "available", "unavailable", "not_requested" ] } } }, "chart": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "available", "unavailable", "not_requested" ] } } }, "launch": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "available", "unavailable", "not_requested" ] } } }, "agents": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "available", "unavailable", "not_requested" ] } } }, "security": { "type": "object", "required": [ "status", "missingFields", "conflictingFields" ], "properties": { "status": { "type": "string", "enum": [ "available", "partial", "unavailable" ], "description": "Coverage of the five security fields: available = all known, partial = some known, unavailable = none known. Not a safety verdict. Always requested, including include=none." }, "missingFields": { "type": "array", "items": { "type": "string", "enum": [ "isHoneypot", "buyTaxPct", "sellTaxPct", "isProxy", "liquidityBurnPct" ] }, "description": "Names of security fields that are null. security_data_incomplete is emitted when this list is nonempty." }, "conflictingFields": { "type": "array", "items": { "type": "string", "enum": [ "isHoneypot", "buyTaxPct", "sellTaxPct", "isProxy", "liquidityBurnPct" ] }, "description": "Fields with conflicting observations, returned as null and also listed in missingFields. Raises security_data_conflict. Empty when no conflict was observed." } } } } }, "warnings": { "type": "array", "items": { "type": "string" } }, "attribution": { "type": "object", "required": [ "text", "url" ], "properties": { "text": { "type": "string" }, "url": { "type": "string", "format": "uri" } } }, "card": { "type": "object", "required": [ "text", "url" ], "properties": { "text": { "type": "string" }, "url": { "type": "string", "format": "uri" } } } } }, "Error": { "type": "object", "required": [ "error", "requestId" ], "properties": { "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } }, "requestId": { "type": "string", "format": "uuid" } } } } } }