{"info":{"contact":{"name":"@bayes309 on Telegram","url":"https://t.me/bayes309"},"description":"# Neutral Trade Bundle API\n\nPartner-facing access to Neutral Trade projection reads and unsigned Solana transaction builders for bundle deposits and withdrawals.\n\n## Projection-backed reads\n\nEvery projection response is served from indexed data with **zero Solana RPC calls on the read path** and zero EVM RPC calls. Projections are designed for second-level freshness after indexed activity, without adding RPC latency to partner requests.\n\nEvery successful projection response includes an `asOf` envelope cursor. Solana retains `{slot, blockTime}`; EVM adds `chain: \"evm:<chainId>\"` and `blockNumber`, with `slot` equal to that block number. Compare different chains by block time, never by slot. When a response contains price-derived values, `priceAsOf` identifies the effective valuation time separately: the CoinGecko reference-price tick time (hourly series, 3-hour freshness window), a historical row's stored source time, or the projection time for a fixed-price Solana devnet asset. Cross-vault rows may also carry their own cursors so consumers can see the exact freshness behind an aggregate.\n\n## EVM vault reads\n\nThe existing directory, detail, share-price, snapshots, metrics, holders, pending, balances, portfolio, actions and position-history routes accept registered EVM vaults. EVM address inputs accept EIP-55 or uniform case and normalize to EIP-55. Vault/user routes require both addresses to belong to the same chain family. The public yields feed includes eligible EVM vaults with their chain identity.\n\nEVM directory rows include `chainId`, `asset.address` (also retained in `asset.mint`), strategy as `programId`, and `evm` configuration with NAV timestamps and read-time staleness. Referral and keeper schedule fields are null. Controller-specific `evm.maxWithdraw` is null because it is not sampled; it is not a promise of instant liquidity. Minimum redeem amounts are share units, while minimum deposits and capacity are asset units.\n\nEVM balances use the normalized projected PPS scale of `10^asset.decimals`, not the raw contract `evm.precision`. Per-user fees, fee overrides, high-water marks and unpaid-fee estimates are null. Per-vault user `/fees` returns HTTP 404 with `code: \"UNSUPPORTED_ON_CHAIN\"` and the registered chain. Referrer cohorts contain Solana vaults only. Transfers appear as `transfer_in` / `transfer_out` actions, with their PPS-valued basis adjustment reflected in position history.\n\nEVM pending rows are controller pools: `requestIds` retains every distinct contributing on-chain ID, `requestId` is the sole ID or null when there are several, and `claimableAssets` is the remaining pooled claimable balance. IDs may be reused. `etaProcessAt` and `cooldownEnd` are null with `etaReason: \"evm_manager_settles\"`. Required damaged EVM projections or older pools lacking request-ID provenance return 503 for the whole response.\n\n## Transaction building\n\n`POST /v2/vault/{id}/tx/deposit` and `POST /v2/vault/{id}/tx/withdraw` are the only request paths allowed to use live Solana RPC. They return unsigned v0 transactions for the supplied user to inspect and sign; the server never holds a private key or submits a transaction. Responses include both `transactionBase64` and the legacy-shaped `instructions[]` representation. A structured policy rejection still returns HTTP 200 with `validation.accepted: false`, while malformed input returns 400 and an onchain preflight failure returns 422 with logs.\n\nTransaction builders are public for browser use and have open CORS only on those two paths. An optional partner key selects that key's own quota and adds its partner identity to operational logs; never embed a partner key in browser code. Builder-code attribution soft-fails to a valid unattributed deposit when it cannot be applied. Failed attribution discloses an existing referrer and whether it matches the requested address when both are known. A client can set requireAttribution to true to receive an ATTRIBUTION_REQUIRED rejection without a transaction instead. Production attribution remains feature-flagged off until the netting keeper supports referral remaining accounts.\n\nThere is deliberately no cancel or claim builder. ntbundle withdrawals follow a keeper-push lifecycle: request, cooldown, then keeper settlement to the user's associated token account.\n\n## Route families\n\nThe public `/v2/lender/*` consent flow issues three-hour challenges for Accountable ToS (SIWE) and the operator-loaded Vault Operator Agreement (VOA). Sign the returned message without modification. Submitting it to `POST /v2/lender/agreements` verifies EOA, EIP-1271 and delegated-EOA signatures on the registered vault chain, then atomically stores consent and consumes the nonce. A replay returns 409 and an expired proof returns 400. This is the sole EVM RPC write path; its `EVM_RPC_URL_<chainId>` capability must be configured for every chain with a registered vault and is separate from Solana transaction building.\n\n`GET /v2/lender/vault/{vaultId}/terms` returns the exact signing text, display text and SHA-256 version. `GET /v2/lender/{wallet}/vault/{vaultId}/eligibility` reads current consent from MongoDB without RPC. ToS alone suffices until a VOA version is loaded, and changing that version requires a new signature. These routes use `Cache-Control: no-store`, a dedicated `LENDER_FLOW_ALLOWED_ORIGINS` allowlist and per-IP/per-wallet write quotas. They do not require partner keys or SIWS sessions. Consent eligibility does not guarantee on-chain deposit execution.\n\nThe two user path families are deliberate. Routes under `/v2/vault/{id}/user/{addr}/*` read one user within the vault selected by `{id}`. Routes under `/v2/users/{addr}/*` read the same user across all in-scope vaults.\n\n## Authentication and access\n\nEvery protected route under `/v2/*` accepts exactly one credential realm. Send a partner key in either `x-api-key: <key>` or `Authorization: Bearer <key>` for projection reads, including `/v2/partner/agreements`. Profile, codes, owner-wallet rotation, and the `/v2/partner/keys` lifecycle subtree accept only a short-lived owner-wallet SIWS session JWT. The public challenge and session proof routes are registered before those credential gates.\n\nAny valid partner API key can read every referrer's summary, payouts, history, users, and flows, plus every vault's holder cohort. Referrer and vault-cohort reads do not require an owner wallet; the referrer users route is intentionally included even though it exposes per-user onchain-derived positions, and the vault users route intentionally shares that any-partner-key access model.\n\nThe `/v2/partner/*` control-plane surface uses a different bearer credential: a short-lived session minted only after server-side owner-wallet Sign-In With Solana (SIWS) verification. The configured portal origins (`PARTNER_SIWS_ORIGIN` plus `PARTNER_SIWS_ALLOWED_ORIGINS`) are the only origins allowed by CORS. When sent, an allowed request `Origin` is bound into the challenge; otherwise the canonical portal origin is used, and other origins receive `403`. `POST /v2/partner/challenge` returns a five-minute wallet input. Its authenticated request ID binds the origin, wallet, purpose, expiry, and optional organization, and its nonce can be consumed only once across API instances. Public challenge and session attempts have per-client fixed-window limits. The public `session` endpoint creates an approved organization for a new verified wallet and then mints a session. Profile, codes, key lifecycle, and owner-wallet rotation require that session and re-check current ownership before reading or changing organization state. API-key lifecycle is under `/v2/partner/keys`. A partner API key cannot issue, list, rotate, or revoke keys. Key issuance always creates a production key and rotation returns plaintext key material once; list and revoke responses expose metadata only.\n\nOwner-wallet rotation also requires a purpose-bound signature from the incoming wallet. It preserves the stable partner ID and key audits while moving login and organization data access. The response does not disclose a session for the incoming wallet to the outgoing owner; the incoming owner signs a fresh session proof after rotation. Historical referral accruals remain with the previous wallet's referrer account.\n\nSelf-serve issuance creates production keys only. Pre-existing sandbox keys remain accepted by the devnet deployment. Rotation preserves environment, expiry, and quota. Its predecessor remains usable for a 60-second grace window, then returns `401`. Explicit revocation is immediate in the datastore and reaches every API instance within the partner authentication cache TTL (at most 60 seconds).\n\nTwo canonical endpoints are intentionally public and need no key. `GET /public/yields` serves catalog-visible vault TVL and gross APY before performance and management fees for external yield aggregators such as DefiLlama. `GET /public/codes/{code}` lets a browser resolve a human-readable builder code to its current referrer address for the SDK `ReferrerCodeResolver` without exposing a partner credential. The public `GET /v1/codes/{code}` compatibility alias remains available for published SDK versions but is deprecated for new integrations.\n\n## Rate limits\n\nLimits are configured per key in fixed windows; reviewed internal keys can be configured without a quota. For rate-limited keys, authenticated responses include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`. A request over quota returns `429` with `Retry-After`.\n\nThe public transaction builders use a dedicated per-IP fixed-window meter (20 builds per 60 seconds by default). Supplying a valid optional partner key switches the request to that key's own quota. Other intentionally public endpoints do not consume partner-key quota; production ingress applies an edge policy where required.\n\n## Scope and degraded data\n\nThe authenticated partner surface includes **every ntbundle-program registry vault** and registered EVM vaults on the read routes described above. Retired legacy Drift vaults are excluded. Directory rows carry nullable catalog metadata as payload hints; `catalog_visible` does not control authenticated-route inclusion. Only `visible: true` rows should be presented in a partner catalog, while `null` means no reviewed catalog decision. Cross-vault interest and position-history responses report legacy history that was excluded in `excludedBundleKeys`.\n\nThe API never fabricates unavailable projection data. Whole-datum reads fail closed when required projections are degraded; aggregate routes identify omitted vaults where their contract allows partial results. An interest bucket or position-history point marked `degraded: true` contains boundary-reconstructed legacy data and must not be treated as exact.\n\nSolana pending-response and simulation `etaProcessAt` values are schedule-derived operational estimates, **not settlement promises**. They can be `null` when timing inputs are incomplete or a request is terminal. Solana simulations use current projected integer math. Deposit shares can differ when price per share moves before netting, and withdrawal asset payouts can differ when price per share moves before settlement after cooldown.\n\n## Getting started\n\n```bash\ncurl --request GET 'https://api.neutral.trade/v2/status' \\\n  --header 'accept: application/json' \\\n  --header 'x-api-key: YOUR_PARTNER_KEY'\n```","title":"Neutral Trade Bundle API","version":"1.0.0"},"openapi":"3.1.0","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"servers":[{"description":"Current API server","url":"https://api.neutral.trade"}],"tags":[{"name":"Lender agreements","description":"Accountable lender consent challenges, signature verification, current terms and versioned eligibility."},{"description":"Unauthenticated browser and aggregator endpoints with short-lived public caching.","name":"Public"},{"description":"Platform-wide TVL, active-user, and cumulative capital aggregates.","name":"Stats"},{"description":"Computed vault returns, risk metrics, fee-adjusted variants, and projection-backed TVL.","name":"Metrics"},{"description":"Projection-only deposit and withdrawal previews with fees, vault checks, cooldowns, and ETA guidance.","name":"Simulations"},{"description":"Public, metered builders for unsigned v0 bundle deposit and withdrawal transactions using live chain preflight.","name":"Transactions"},{"description":"Canonical vault discovery, current configuration, lifecycle status, and holder cohorts.","name":"Vaults"},{"description":"Projection-backed per-vault balances and cross-vault portfolio valuation.","name":"Balances"},{"description":"User pending-request lifecycle, interest-earned history, and position history.","name":"Users"},{"description":"Newest-first indexed and migrated user flow history with opaque pagination.","name":"User actions"},{"description":"Per-wallet indexed management and performance charges plus migrated legacy fee history.","name":"User fees"},{"description":"Current share price, event-resolution PPS ticks, and provenance-aware daily vault history.","name":"Vault history"},{"description":"Scoped builder-code earnings, attributed users and flows, attributed TVL, and payout history.","name":"Referrer"},{"description":"SIWS sessions and wallet onboarding, organization profile, builder codes, owner rotation, API-key lifecycle, and current onchain referral terms.","name":"Partners"},{"description":"Service availability and the newest folded projection cursor.","name":"Status"}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Partner API key supplied in the x-api-key header.","in":"header","name":"x-api-key","type":"apiKey"},"BearerAuth":{"bearerFormat":"Partner API key","description":"Partner API key supplied as Authorization: Bearer <key>.","scheme":"bearer","type":"http"},"SiwsSessionAuth":{"bearerFormat":"SIWS session JWT","description":"Short-lived dashboard session minted only after owner-wallet Sign-In With Solana verification. Partner API keys are not accepted by lifecycle routes.","scheme":"bearer","type":"http"}},"schemas":{"PublicYieldsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/NullableAsOf"},"data":{"$ref":"#/components/schemas/PublicYieldsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true},"dataAsOf":{"$ref":"#/components/schemas/NullableAsOf"},"computedAt":{"type":["integer","null"],"minimum":0,"description":"Oldest metrics computation time among returned vaults, in Unix seconds; null for an empty result.","example":1800000030},"indexer_asOf":{"type":["string","null"],"format":"date-time","description":"UTC block time of the latest successfully projected Solana event, including user-only events. Null until the projection worker records progress. This is recent activity, not a heartbeat or proof of gap-free ingestion.","example":"2027-01-15T08:00:00.000Z"}},"required":["asOf","data","success","dataAsOf","computedAt","indexer_asOf"]},"NullableAsOf":{"type":["object","null"],"properties":{"blockTime":{"type":"integer","minimum":0,"example":1800000000},"slot":{"type":"integer","minimum":0,"example":300000000},"chain":{"allOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}],"description":"Chain owning this cursor. Omitted on legacy-compatible Solana responses (means solana); required for EVM."},"blockNumber":{"type":"integer","minimum":0,"description":"Present for EVM and equal to slot. slot retains its compatibility field name.","example":22559521}},"required":["blockTime","slot"]},"ChainId":{"anyOf":[{"type":"string","enum":["solana"]},{"type":"string","pattern":"^evm:[1-9]\\d*$"}],"description":"solana or evm:<positive numeric chainId>, for example evm:4663."},"PublicYieldsData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"description":"Number of rows returned in vaults; unavailableVaults are not counted.","example":11},"unavailableVaults":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"description":"Catalog-visible bundle addresses omitted because current projection or metrics state is missing or degraded.","example":["2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"]},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/PublicYieldVault"},"description":"Catalog-visible vaults with available metrics, sorted by bundle address."}},"required":["count","unavailableVaults","vaults"]},"PublicYieldVault":{"type":"object","properties":{"apy7d":{"type":["number","null"],"description":"Trailing 7-day PPS APY as a decimal fraction before the API fee adjustment (EVM sampled PPS already reflects protocol dilution); null while the window has insufficient PPS history.","example":0.104},"apy30d":{"type":["number","null"],"description":"Trailing 30-day PPS APY as a decimal fraction before the API fee adjustment (EVM sampled PPS already reflects protocol dilution); null while the window has insufficient PPS history.","example":0.095},"apy90d":{"type":["number","null"],"description":"Trailing 90-day PPS APY as a decimal fraction before the API fee adjustment (EVM sampled PPS already reflects protocol dilution); null while the window has insufficient PPS history.","example":0.09},"apyInception":{"type":["number","null"],"description":"Since-inception PPS APY as a decimal fraction before the API fee adjustment (EVM sampled PPS already reflects protocol dilution); null while the window has insufficient PPS history.","example":0.115},"asset":{"$ref":"#/components/schemas/VaultAsset"},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"chain":{"$ref":"#/components/schemas/ChainId"},"dataAsOf":{"$ref":"#/components/schemas/AsOf"},"computedAt":{"type":"integer","minimum":0,"description":"Unix-seconds time when this vault’s yield metrics were recalculated; independent of its last on-chain observation.","example":1800000030},"name":{"type":["string","null"],"minLength":1,"example":"Cross-Exchange Arb"},"programId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"},"rateUnit":{"type":"string","enum":["decimal"],"example":"decimal"},"tvlUsd":{"type":["number","null"],"description":"Projection-backed vault TVL in USD. Current mainnet valuation uses the CoinGecko reference-price tick time (hourly series, 3-hour freshness window); tvlUsd is null when no eligible tick exists. Devnet assets are fixed at $1.0, while mainnet assets are never assumed to be at par.","example":2807621.4}},"required":["apy7d","apy30d","apy90d","apyInception","asset","bundleKey","chain","dataAsOf","computedAt","name","programId","rateUnit","tvlUsd"]},"VaultAsset":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]},"decimals":{"type":"integer","minimum":0,"maximum":18,"example":6},"mint":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"symbol":{"type":["string","null"],"minLength":1,"example":"USDC"}},"required":["decimals","mint","symbol"]},"AsOf":{"type":"object","properties":{"blockTime":{"type":"integer","minimum":0,"example":1800000000},"slot":{"type":"integer","minimum":0,"example":300000000},"chain":{"allOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}],"description":"Chain owning this cursor. Omitted on legacy-compatible Solana responses (means solana); required for EVM."},"blockNumber":{"type":"integer","minimum":0,"description":"Present for EVM and equal to slot. slot retains its compatibility field name.","example":22559521}},"required":["blockTime","slot"]},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","example":"OWNER_WALLET_REQUIRED"},"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Valid API key required"},"success":{"type":"boolean","enum":[false],"example":false}},"required":["error","message","success"]},"PartnerCodeResolutionResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PartnerCodeResolutionData"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"PartnerCodeResolutionData":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z0-9][A-Z0-9_-]{0,63}$","example":"ACME"},"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["code","referrer"]},"DepositTransactionResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/TxAsOf"},"data":{"$ref":"#/components/schemas/DepositTransactionData"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"TxAsOf":{"type":"object","properties":{"blockTime":{"type":"integer","minimum":0,"description":"Server's Unix-seconds observation time of the blockhash fetch.","example":1800000000},"slot":{"type":"integer","minimum":0,"description":"RPC context slot returned by the blockhash fetch.","example":300000000}},"required":["blockTime","slot"]},"DepositTransactionData":{"type":"object","properties":{"blockhash":{"type":"string","description":"Present exactly when validation.accepted is true.","example":"11111111111111111111111111111111"},"computeUnitLimit":{"type":"integer","exclusiveMinimum":0,"example":240000},"instructions":{"type":"array","items":{"$ref":"#/components/schemas/WireInstruction"},"description":"Present exactly when validation.accepted is true. Instructions byte-match transactionBase64 and use the legacy /api/v1 wire shape."},"lastValidBlockHeight":{"type":"integer","minimum":0,"example":280000000},"priorityFeeMicroLamports":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"25000"},"signers":{"type":"array","items":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"description":"Present exactly when validation.accepted is true. The listed wallet must sign the unsigned transaction."},"simulation":{"type":"string","enum":["simulated","skipped"],"example":"simulated"},"transactionBase64":{"type":"string","description":"Present exactly when validation.accepted is true. Unsigned v0 wire transaction with zero-filled signature slots.","example":"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAA=="},"validation":{"$ref":"#/components/schemas/TransactionValidation"},"attribution":{"$ref":"#/components/schemas/DepositAttribution"}},"required":["validation"]},"WireInstruction":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"isSigner":{"type":"boolean"},"isWritable":{"type":"boolean"},"pubkey":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["isSigner","isWritable","pubkey"]}},"dataBase64":{"type":"string","example":"AgCqBAY="},"programId":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["accounts","dataBase64","programId"]},"TransactionValidation":{"type":"object","properties":{"accepted":{"type":"boolean","example":true},"rejectionReasons":{"type":"array","items":{"$ref":"#/components/schemas/TransactionRejectionReason"}}},"required":["accepted","rejectionReasons"]},"TransactionRejectionReason":{"type":"object","properties":{"code":{"type":"string","enum":["DEPOSIT_AMOUNT_ZERO","WITHDRAWAL_AMOUNT_ZERO","MIN_DEPOSIT_AMOUNT_NOT_MET","MAX_DEPOSIT_AMOUNT_EXCEEDED","VAULT_PAUSED","VAULT_PERMISSIONED","UNSUPPORTED_VAULT","ATTRIBUTION_REQUIRED","USER_BUNDLE_ACCOUNT_NOT_FOUND","WITHDRAWAL_SHARES_ZERO"],"example":"MIN_DEPOSIT_AMOUNT_NOT_MET"},"message":{"type":"string","minLength":1,"example":"Deposit amount is below the vault minimum"}},"required":["code","message"]},"DepositAttribution":{"anyOf":[{"type":"object","properties":{"applied":{"type":"boolean","enum":[true]},"code":{"type":"string","pattern":"^[A-Z0-9][A-Z0-9_-]{0,63}$","example":"NEUTRAL"},"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["applied","referrer"]},{"type":"object","properties":{"applied":{"type":"boolean","enum":[false]},"existingReferrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Current onchain referrer when the user bundle account has an existing attribution.","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"existingReferrerMatchesRequest":{"type":"boolean","description":"Whether existingReferrer equals the concrete referrer address requested directly or resolved from code.","example":true},"reason":{"type":"string","enum":["ATTRIBUTION_NOT_YET_ENABLED","UNKNOWN_CODE","REFERRALS_DISABLED","INVALID_REFERRER","REFERRAL_ALREADY_SET","USER_BUNDLE_ACCOUNT_HAS_ACTIVITY","REFERRER_NOT_REGISTERED","REFERRER_DEACTIVATED","REFERRER_DEPOSIT_TOO_LOW","BUILDER_DEPOSIT_AMOUNT_TOO_LOW"],"example":"ATTRIBUTION_NOT_YET_ENABLED"},"requiredGrossDepositAmount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"200000000"}},"required":["applied","reason"]}]},"TxErrorResponse":{"type":"object","properties":{"code":{"type":"string","example":"VAULT_NOT_FOUND"},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Registered ntbundle vault not found"},"success":{"type":"boolean","enum":[false],"example":false}},"required":["error","message","success"]},"SimulationFailedResponse":{"type":"object","properties":{"code":{"type":"string","enum":["SIMULATION_FAILED"]},"error":{"type":"string","example":"Unprocessable Entity"},"logs":{"type":"array","items":{"type":"string"},"example":["Program log: AnchorError"]},"message":{"type":"string","example":"Transaction preflight simulation failed"},"success":{"type":"boolean","enum":[false]}},"required":["code","error","logs","message","success"]},"DepositTransactionRequest":{"type":"object","properties":{"amountRaw":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Raw asset minor units as a canonical unsigned u64 decimal string. Zero returns a structured rejection verdict.","example":"100000000"},"code":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$","description":"Case-insensitive builder code, canonicalized to uppercase before lookup.","example":"NEUTRAL"},"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"requireAttribution":{"type":"boolean","description":"When true, an attribution failure returns validation.accepted=false without a transaction instead of building an unattributed deposit.","example":true},"userAddress":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["amountRaw","userAddress"]},"WithdrawTransactionResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/TxAsOf"},"data":{"$ref":"#/components/schemas/WithdrawTransactionData"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"WithdrawTransactionData":{"type":"object","properties":{"blockhash":{"type":"string","description":"Present exactly when validation.accepted is true.","example":"11111111111111111111111111111111"},"computeUnitLimit":{"type":"integer","exclusiveMinimum":0,"example":240000},"instructions":{"type":"array","items":{"$ref":"#/components/schemas/WireInstruction"},"description":"Present exactly when validation.accepted is true. Instructions byte-match transactionBase64 and use the legacy /api/v1 wire shape."},"lastValidBlockHeight":{"type":"integer","minimum":0,"example":280000000},"priorityFeeMicroLamports":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"25000"},"signers":{"type":"array","items":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"description":"Present exactly when validation.accepted is true. The listed wallet must sign the unsigned transaction."},"simulation":{"type":"string","enum":["simulated","skipped"],"example":"simulated"},"transactionBase64":{"type":"string","description":"Present exactly when validation.accepted is true. Unsigned v0 wire transaction with zero-filled signature slots.","example":"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAA=="},"validation":{"$ref":"#/components/schemas/TransactionValidation"},"sharesAmount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Program-computed raw u128 shares present when validation.accepted is true.","example":"50000000"}},"required":["validation"]},"WithdrawTransactionRequest":{"type":"object","properties":{"amountRaw":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Raw asset minor units as a canonical unsigned u64 decimal string. Zero returns a structured rejection verdict.","example":"100000000"},"userAddress":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana account address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"withdrawAll":{"type":"boolean","example":false}},"required":["userAddress"]},"PartnerChallengeResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"expiresAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"input":{"$ref":"#/components/schemas/PartnerSiwsInput"},"message":{"type":"string","minLength":1,"maxLength":4096,"example":"partners.neutral.trade wants you to sign in with your Solana account:\n2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["expiresAt","input","message"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"PartnerSiwsInput":{"type":"object","properties":{"address":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"chainId":{"type":"string","enum":["mainnet","devnet"],"example":"mainnet"},"domain":{"type":"string","minLength":1,"example":"partners.neutral.trade"},"expirationTime":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"issuedAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"nonce":{"type":"string","pattern":"^[A-Za-z0-9]{8,64}$","example":"Nonce12345678"},"requestId":{"type":"string","minLength":1,"example":"SIGNED_CHALLENGE_REQUEST_ID"},"resources":{"type":"array","items":{"type":"string","format":"uri"},"example":["urn:neutral-trade:partner:acme-payments"]},"statement":{"type":"string","minLength":1,"example":"Sign in to the Neutral Trade partner portal."},"uri":{"type":"string","format":"uri","example":"https://partners.neutral.trade"},"version":{"type":"string","enum":["1"],"example":"1"}},"required":["address","chainId","domain","expirationTime","issuedAt","nonce","requestId","statement","uri","version"]},"PartnerChallengeRequest":{"type":"object","properties":{"partnerId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"acme-payments"},"purpose":{"type":"string","enum":["session","rotate-owner"],"example":"session"},"wallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["purpose","wallet"],"additionalProperties":false},"PartnerSessionResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"expiresAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"ownerWallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"partnerId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"acme-payments"},"sessionToken":{"type":"string","minLength":1,"example":"HEADER.PAYLOAD.SIGNATURE"}},"required":["expiresAt","ownerWallet","partnerId","sessionToken"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"PartnerSessionRequest":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4096,"example":"partners.neutral.trade wants you to sign in with your Solana account:\n2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"signature":{"type":"string","minLength":1,"maxLength":128,"description":"Base58, base64, or base64url.","example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"wallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["message","signature","wallet"],"additionalProperties":false},"PartnerProfileResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/PartnerProfile"}},"required":["profile"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"PartnerProfile":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"jurisdiction":{"type":["string","null"],"example":"SG"},"kybStatus":{"type":"string","enum":["not_started","pending","approved","rejected"],"example":"not_started"},"legalName":{"type":"string","example":"Acme Payments Pte. Ltd."},"ownerWallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"partnerId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"acme-payments"},"registrationNumber":{"type":["string","null"],"example":"202600001A"},"tier":{"type":"string","example":"standard"}},"required":["createdAt","jurisdiction","kybStatus","legalName","ownerWallet","partnerId","registrationNumber","tier"]},"PartnerCodeListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"codes":{"type":"array","items":{"$ref":"#/components/schemas/PartnerCode"}}},"required":["codes"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"PartnerCode":{"type":"object","properties":{"active":{"type":"boolean","example":true},"code":{"type":"string","pattern":"^[A-Z0-9][A-Z0-9_-]{0,63}$","example":"ACME_2026"},"createdAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"}},"required":["active","code","createdAt","referrer","updatedAt"]},"UpsertPartnerCodeResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"active":{"type":"boolean","example":true},"code":{"type":"string","pattern":"^[A-Z0-9][A-Z0-9_-]{0,63}$","example":"ACME_2026"},"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["active","code","referrer"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"UpsertPartnerCodeRequest":{"type":"object","properties":{"active":{"type":"boolean","example":true},"code":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$","example":"acme_2026"}},"required":["active","code"],"additionalProperties":false},"RotatePartnerOwnerResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"historicalAccruals":{"type":"object","properties":{"remainWithPreviousWallet":{"type":"boolean","enum":[true],"example":true},"wallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["remainWithPreviousWallet","wallet"]},"ownerWallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"partnerId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"acme-payments"},"previousOwnerWallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["historicalAccruals","ownerWallet","partnerId","previousOwnerWallet"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"RotatePartnerOwnerRequest":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4096,"example":"partners.neutral.trade wants you to sign in with your Solana account:\n2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"signature":{"type":"string","minLength":1,"maxLength":128,"description":"Base58, base64, or base64url.","example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"wallet":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"}},"required":["message","signature","wallet"],"additionalProperties":false},"IssuedPartnerKeyResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"key":{"type":"string","example":"nt_prod_PLAINTEXT_SHOWN_ONCE"},"metadata":{"$ref":"#/components/schemas/PartnerKeyMetadata"}},"required":["key","metadata"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"PartnerKeyMetadata":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"},"env":{"type":"string","enum":["sandbox","prod"],"example":"sandbox"},"expiresAt":{"type":["string","null"],"format":"date-time","example":"2026-08-06T00:00:00.000Z"},"id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"018f2c70-66b8-7ef4-a672-4f8657e5d12c"},"lastUsedAt":{"type":["string","null"],"format":"date-time","example":"2026-08-06T00:00:00.000Z"},"rateLimit":{"type":["object","null"],"properties":{"requests":{"type":"integer","exclusiveMinimum":0,"example":300},"windowSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":86400,"example":60}},"required":["requests","windowSeconds"],"example":{"requests":300,"windowSeconds":60}},"revokedAt":{"type":["string","null"],"format":"date-time","example":"2026-08-06T00:00:00.000Z"},"rotatedAt":{"type":["string","null"],"format":"date-time","example":"2026-08-06T00:00:00.000Z"},"rotatedFromId":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":null},"rotatedToId":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":null},"status":{"type":"string","enum":["active","expired","grace","revoked"],"example":"active"},"usageCount":{"type":"integer","minimum":0,"example":42}},"required":["createdAt","env","expiresAt","id","lastUsedAt","rateLimit","revokedAt","rotatedAt","rotatedFromId","rotatedToId","status","usageCount"]},"IssuePartnerKeyRequest":{"type":"object","properties":{"expiresAt":{"type":"string","format":"date-time","example":"2026-08-06T00:00:00.000Z"}},"additionalProperties":false},"PartnerKeyListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/PartnerKeyMetadata"},"example":[]}},"required":["keys"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"RevokedPartnerKeyResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/PartnerKeyMetadata"}},"required":["metadata"]},"success":{"type":"boolean","enum":[true],"example":true}},"required":["data","success"]},"StatusResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/StatusData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true},"indexer_asOf":{"type":["string","null"],"format":"date-time","description":"UTC block time of the latest successfully projected Solana event, including user-only events. Null until the projection worker records progress. This is recent activity, not a heartbeat or proof of gap-free ingestion.","example":"2027-01-15T08:00:00.000Z"}},"required":["asOf","data","success","indexer_asOf"]},"StatusData":{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"example":"ok"}},"required":["status"]},"StatsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/StatsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"StatsData":{"type":"object","properties":{"aggregate":{"$ref":"#/components/schemas/StatsAggregate"},"scope":{"type":"string","enum":["ntbundle-program-vaults"],"description":"All Solana ntbundle-program vaults and EVM vaults present in bundle_registry are included; the scope string retains its compatibility spelling. catalog_visible is a payload hint and does not control authenticated API inclusion; retired legacy Drift-program vaults are excluded.","example":"ntbundle-program-vaults"},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/StatsVaultRow"}}},"required":["aggregate","scope","vaults"]},"StatsAggregate":{"type":"object","properties":{"capitalRaised":{"$ref":"#/components/schemas/StatsCapitalRaised"},"tvl":{"$ref":"#/components/schemas/StatsTvl"},"userCount":{"type":"integer","minimum":0,"example":128}},"required":["capitalRaised","tvl","userCount"]},"StatsCapitalRaised":{"type":"object","properties":{"assets":{"type":"array","items":{"$ref":"#/components/schemas/StatsAssetAmount"}},"basis":{"type":"string","enum":["legacy-contributed-plus-deposit-gross"],"example":"legacy-contributed-plus-deposit-gross"},"throughDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-08-02"}},"required":["assets","basis","throughDate"]},"StatsAssetAmount":{"type":"object","properties":{"amount":{"$ref":"#/components/schemas/TokenAmount"},"asset":{"$ref":"#/components/schemas/StatsAsset"}},"required":["amount","asset"]},"TokenAmount":{"type":"object","properties":{"raw":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"123450000"},"token":{"type":"string","pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d*[1-9])?$","example":"123.45"}},"required":["raw","token"]},"StatsAsset":{"allOf":[{"$ref":"#/components/schemas/AnalyticsAsset"},{"type":"object","properties":{},"required":["chain"]}]},"AnalyticsAsset":{"allOf":[{"$ref":"#/components/schemas/BalanceAsset"},{"type":"object","properties":{"mint":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]}}}]},"BalanceAsset":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]},"chain":{"$ref":"#/components/schemas/ChainId"},"decimals":{"type":"integer","minimum":0,"maximum":18,"example":6},"mint":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"symbol":{"type":"string","minLength":1,"example":"USDC"}},"required":["decimals","mint"]},"StatsTvl":{"type":"object","properties":{"assets":{"type":"array","items":{"$ref":"#/components/schemas/StatsAssetValue"}},"missingPriceMints":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]},"example":["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]},"valueUsd":{"type":"number","example":12345678.9}},"required":["assets","missingPriceMints"]},"StatsAssetValue":{"type":"object","properties":{"asset":{"$ref":"#/components/schemas/StatsAsset"},"value":{"$ref":"#/components/schemas/TokenValue"}},"required":["asset","value"]},"TokenValue":{"allOf":[{"$ref":"#/components/schemas/TokenAmount"},{"type":"object","properties":{"usd":{"type":"number","example":123.57}}}]},"StatsVaultRow":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"asset":{"$ref":"#/components/schemas/StatsAsset"},"tvl":{"$ref":"#/components/schemas/TokenValue"},"userCount":{"type":"integer","minimum":0,"example":42},"vault":{"$ref":"#/components/schemas/StatsVault"}},"required":["asOf","asset","tvl","userCount","vault"]},"StatsVault":{"allOf":[{"$ref":"#/components/schemas/AnalyticsVault"},{"type":"object","properties":{},"required":["chain"]}]},"AnalyticsVault":{"allOf":[{"$ref":"#/components/schemas/BalanceVault"},{"type":"object","properties":{"programId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]}}}]},"BalanceVault":{"type":"object","properties":{"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"category":{"type":"string","minLength":1,"example":"market-neutral"},"chain":{"$ref":"#/components/schemas/ChainId"},"chainId":{"type":"integer","exclusiveMinimum":0,"example":4663},"id":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"name":{"type":"string","minLength":1,"example":"Master Bundle"},"programId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"}},"required":["bundleKey","id","programId"]},"VaultDirectoryResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultDirectoryData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultDirectoryData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"description":"Number of rows returned in vaults; unavailableVaults are not counted.","example":29},"unavailableVaults":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"description":"Registry bundle addresses omitted from vaults because current projection state is missing or degraded.","example":["2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"]},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/VaultSummary"},"description":"Canonical bundle_registry rows with available projection state, sorted by bundle address."}},"required":["count","unavailableVaults","vaults"]},"VaultSummary":{"type":"object","properties":{"asset":{"$ref":"#/components/schemas/VaultAsset"},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"category":{"type":["string","null"],"enum":["marketNeutral","directional","privateCredit","etf","savings","fundOfFund","rwa","solYield",null],"example":"marketNeutral"},"chain":{"allOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}],"description":"Chain identifier: solana or evm:<numeric chainId>, such as evm:4663.","example":"solana"},"chainId":{"type":"integer","exclusiveMinimum":0,"example":4663},"depositFeeBps":{"type":"number","minimum":0,"example":10},"deprecated":{"type":["boolean","null"],"example":false},"enabled":{"type":["boolean","null"],"example":true},"evm":{"$ref":"#/components/schemas/EvmVaultConfig"},"legacyVaultId":{"type":["integer","null"],"minimum":0,"example":71},"managementFeeBps":{"type":"number","minimum":0,"example":100},"manager":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}],"description":"Current vault manager: the latest projected NewManagerSet, otherwise the registry seed value. Null when neither is known.","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"maxCap":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1000000000000"},"maxDepositAmount":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1000000000000","description":"Raw asset units. For EVM, sampled maxDeposit at or after the accounting block, otherwise the projected value; null when unavailable."},"minDepositAmount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1000000"},"minWithdrawAmount":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","description":"Exact token minor-unit integer. Solana minimum withdrawal in raw asset units; EVM minimum redeem in raw share units.","example":"10000000"},"name":{"type":["string","null"],"minLength":1,"example":"Cross-Exchange Arb"},"ntMultiplier":{"type":["number","null"],"exclusiveMinimum":0,"description":"Static NT-points multiplier from reviewed vault configuration; not a computed points balance.","example":2},"paused":{"type":["boolean","null"],"example":false,"description":"Latest projected or sampled pause flag; null when no EVM observation is available."},"performanceFeeBps":{"type":"number","minimum":0,"example":2000},"private":{"type":["boolean","null"],"example":false},"processFrequency":{"type":["string","null"],"enum":["30min","hourly","daily",null],"example":"daily"},"processTime":{"type":["array","null"],"items":{"type":"integer","minimum":0},"example":[14,30]},"programId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"},"referral":{"$ref":"#/components/schemas/VaultReferral"},"visible":{"type":["boolean","null"],"description":"Catalog review state: true is approved for presentation, false is explicitly hidden, and null has no reviewed decision. Present only true rows in a partner catalog.","example":true},"withdrawalDelay":{"type":["integer","null"],"minimum":0,"description":"Solana withdrawal lock in seconds from the latest DelaysSet or continuity seed; null for EVM.","example":86400},"withdrawalFeeBps":{"type":"number","minimum":0,"example":30},"withdrawalRedemptionRequestCutoffAt":{"type":["integer","null"],"minimum":0,"example":1800007200},"withdrawalRedemptionUnlockCurrentCycleAt":{"type":["integer","null"],"minimum":0,"example":1800086400},"withdrawalRedemptionUnlockNextCycleAt":{"type":["integer","null"],"minimum":0,"example":1800172800},"withdrawalTMax":{"type":["integer","null"],"description":"Solana withdrawal-curve upper bound in seconds from the latest DelaysSet; null for EVM.","example":3600},"withdrawalTMin":{"type":["integer","null"],"description":"Solana withdrawal-curve lower bound in seconds from the latest DelaysSet; null for EVM.","example":60}},"required":["asset","bundleKey","category","chain","depositFeeBps","deprecated","enabled","legacyVaultId","managementFeeBps","manager","maxCap","maxDepositAmount","minDepositAmount","minWithdrawAmount","name","ntMultiplier","paused","performanceFeeBps","private","processFrequency","processTime","programId","referral","visible","withdrawalDelay","withdrawalFeeBps","withdrawalRedemptionRequestCutoffAt","withdrawalRedemptionUnlockCurrentCycleAt","withdrawalRedemptionUnlockNextCycleAt","withdrawalTMax","withdrawalTMin"]},"EvmVaultConfig":{"type":"object","properties":{"accountableLoanId":{"type":["integer","null"],"minimum":0,"example":1},"dvnPublisher":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"0x4150A5394C3E7D0A192E72091ae76E4a43F1f22F"},"feeManager":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"0x2A69Cf4a2fAE6DA9317298818B416F62e253E784"},"loanState":{"type":["integer","null"],"minimum":0,"example":2},"maxWithdraw":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":null,"description":"Controller-specific maxWithdraw is not sampled; null means unavailable. Clients must check the contract before submitting a withdrawal."},"navGraceDeadline":{"type":["integer","null"],"minimum":0,"example":1800086400},"navLastMeasuredAt":{"type":["integer","null"],"minimum":0,"example":1800000000},"navStale":{"type":["boolean","null"],"example":false,"description":"Evaluated at request time for active loan states. Null when the NAV gate inputs are not yet projected."},"precision":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1000000000000000000000000000000000000","description":"Vault precision() used by the contract. Shared API PPS is already normalized to asset.decimals."},"sharesTransferable":{"type":"boolean","example":true},"strategy":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"0xF62c201e9A28F6A57C4262004dd2e8B8e95bB1eC"}},"required":["accountableLoanId","dvnPublisher","feeManager","loanState","maxWithdraw","navGraceDeadline","navLastMeasuredAt","navStale","precision","sharesTransferable","strategy"]},"VaultReferral":{"type":["object","null"],"properties":{"enabled":{"type":"boolean","description":"Whether referral accrual is enabled for this vault.","example":true},"pfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Compatibility base performance-fee rate in basis points: the frozen flat value when present, otherwise the tier schedule rate at zero referred deposits.","example":2000},"mfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Compatibility base management-fee rate in basis points: the frozen flat value when present, otherwise the tier schedule rate at zero referred deposits.","example":2000},"minDepositAmount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Exact token minor-unit minimum deposit for referral eligibility. Apply asset.decimals for display; this is never a human-unit float.","example":"5000000"},"tiers":{"type":"array","items":{"type":"object","properties":{"threshold":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Exact referred-net-deposit threshold in this vault asset’s token minor unit.","example":"10000000000"},"pfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"example":1250},"mfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"example":625}},"required":["threshold","pfeeBps","mfeeBps"]},"maxItems":5,"description":"Ordered active referral-tier ladder. Empty only when the projected compatibility config predates tier schedules or the vault has no active tiers.","example":[{"threshold":"0","pfeeBps":1000,"mfeeBps":500},{"threshold":"10000000000","pfeeBps":1250,"mfeeBps":625}]}},"required":["enabled","pfeeBps","mfeeBps","minDepositAmount","tiers"],"description":"Vault-level referral configuration and ordered active tier ladder from bundle_state_current. Null for EVM, which has no on-chain referral attribution, or when every referral projection field is absent on a legacy row.","example":{"enabled":true,"pfeeBps":2000,"mfeeBps":2000,"minDepositAmount":"5000000","tiers":[{"threshold":"0","pfeeBps":1000,"mfeeBps":500},{"threshold":"10000000000","pfeeBps":1250,"mfeeBps":625}]}},"VaultDetailResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultDetail"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultDetail":{"allOf":[{"$ref":"#/components/schemas/VaultSummary"},{"type":"object","properties":{"lastNettingAt":{"type":["integer","null"],"minimum":0,"example":1799996400},"nextProcessEta":{"type":["integer","null"],"minimum":0,"example":1800003600},"oracleAgeSeconds":{"type":"number","minimum":0,"example":30}},"required":["lastNettingAt","nextProcessEta","oracleAgeSeconds"]}]},"VaultMetricsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultMetricsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultMetricsData":{"type":["object","null"],"properties":{"aprDayApplied":{"$ref":"#/components/schemas/MetricAprDayApplied"},"apr7d":{"$ref":"#/components/schemas/MetricRate"},"apr7dAfterFees":{"$ref":"#/components/schemas/MetricRate"},"apr30d":{"$ref":"#/components/schemas/MetricRate"},"apr30dAfterFees":{"$ref":"#/components/schemas/MetricRate"},"apr90d":{"$ref":"#/components/schemas/MetricRate"},"apr90dAfterFees":{"$ref":"#/components/schemas/MetricRate"},"aprInception":{"$ref":"#/components/schemas/MetricRate"},"aprInceptionAfterFees":{"$ref":"#/components/schemas/MetricRate"},"apy7d":{"$ref":"#/components/schemas/MetricRate"},"apy7dAfterFees":{"$ref":"#/components/schemas/MetricRate"},"apy30d":{"$ref":"#/components/schemas/MetricRate"},"apy30dAfterFees":{"$ref":"#/components/schemas/MetricRate"},"apy90d":{"$ref":"#/components/schemas/MetricRate"},"apy90dAfterFees":{"$ref":"#/components/schemas/MetricRate"},"apyInception":{"$ref":"#/components/schemas/MetricRate"},"apyInceptionAfterFees":{"$ref":"#/components/schemas/MetricRate"},"computedAt":{"type":"integer","minimum":0,"description":"Unix timestamp in seconds when this bundle_metrics_current snapshot was computed; dateFromSnapshot is its ISO-8601 alias.","example":1800000030},"display":{"$ref":"#/components/schemas/VaultMetricsDisplay"},"dateFromSnapshot":{"type":"string","format":"date-time","description":"UTC ISO-8601 timestamp alias of computedAt, retained for legacy partner contract parity.","example":"2027-01-15T08:00:30.000Z"},"feeSchedule":{"$ref":"#/components/schemas/MetricFeeSchedule"},"firstTickBlockTime":{"type":"integer","minimum":0,"description":"Unix timestamp in seconds of the first PPS tick; roiSince is its UTC date.","example":1790000000},"isAprTargeted":{"type":"boolean","enum":[false],"example":false},"isMaxDrawdownTargeted":{"type":"boolean","enum":[false],"example":false},"isSharpeRatioTargeted":{"type":"boolean","enum":[false],"example":false},"maxDrawdown":{"$ref":"#/components/schemas/MetricRate"},"metricSource":{"type":"string","enum":["bundle_metrics_current"],"example":"bundle_metrics_current"},"rateUnit":{"type":"string","enum":["decimal"],"example":"decimal"},"roi":{"type":["number","null"],"description":"All-time simple PPS return as latest PPS / first PPS - 1. Decimal fraction (0.12 means 12%), never annualized; null only when the opening PPS is zero or the projection awaits its NEU-306 rewrite.","example":0.12},"roi30d":{"type":["number","null"],"description":"Simple PPS return over the same opening tick selected for apr30d: latest PPS / opening PPS - 1. Decimal fraction, never annualized; inspect aprDayApplied.apr30d for the exact elapsed coverage.","example":0.03},"roiSince":{"type":"string","format":"date","description":"UTC date of the first PPS tick from which roi is measured.","example":"2026-09-21"},"roiUsesLegacyPps":{"type":["boolean","null"],"description":"True when either endpoint PPS behind roi is a migrated legacy daily-mean tick; null only until a pre-NEU-306 current-metrics row is rewritten.","example":true},"roi30dUsesLegacyPps":{"type":["boolean","null"],"description":"True when either endpoint PPS behind roi30d is a migrated legacy daily-mean tick; null only until a pre-NEU-306 current-metrics row is rewritten.","example":false},"scope":{"type":"string","enum":["ntbundle-program-vaults"],"description":"All Solana ntbundle-program vaults and EVM vaults present in bundle_registry are included; the scope string retains its compatibility spelling. catalog_visible is a payload hint and does not control authenticated API inclusion; retired legacy Drift-program vaults are excluded.","example":"ntbundle-program-vaults"},"sharpeRatio30d":{"type":["number","null"],"example":1.42},"tvl":{"$ref":"#/components/schemas/VaultMetricTvl"},"vault":{"$ref":"#/components/schemas/AnalyticsVault"}},"required":["aprDayApplied","apr7d","apr7dAfterFees","apr30d","apr30dAfterFees","apr90d","apr90dAfterFees","aprInception","aprInceptionAfterFees","apy7d","apy7dAfterFees","apy30d","apy30dAfterFees","apy90d","apy90dAfterFees","apyInception","apyInceptionAfterFees","computedAt","display","dateFromSnapshot","feeSchedule","firstTickBlockTime","isAprTargeted","isMaxDrawdownTargeted","isSharpeRatioTargeted","maxDrawdown","metricSource","rateUnit","roi","roi30d","roiSince","roiUsesLegacyPps","roi30dUsesLegacyPps","scope","sharpeRatio30d","tvl","vault"],"description":"null when the vault is registered and its state is projected but it has no PPS tick yet (it has never netted), so there are no metrics to compute."},"MetricAprDayApplied":{"type":"object","properties":{"apr7d":{"type":["number","null"],"minimum":0,"description":"Exact elapsed days between the PPS ticks used for apr7d; null when apr7d is unavailable or until a pre-NEU-306 current-metrics row is rewritten.","example":7.04},"apr30d":{"type":["number","null"],"minimum":0,"description":"Exact elapsed days between the PPS ticks used for apr30d; null when apr30d is unavailable or until a pre-NEU-306 current-metrics row is rewritten.","example":30.02},"apr90d":{"type":["number","null"],"minimum":0,"description":"Exact elapsed days between the PPS ticks used for apr90d; null when apr90d is unavailable or until a pre-NEU-306 current-metrics row is rewritten.","example":90.01}},"required":["apr7d","apr30d","apr90d"],"description":"Per-fixed-window replacement for the legacy scalar aprDayApplied. Values are elapsed seconds divided by 86400 for the actual opening and closing PPS ticks; sparse or young histories can differ from the nominal window. No dynamic target or marketing APR is substituted."},"MetricRate":{"type":["number","null"],"description":"Decimal fraction (0.12 means 12%); null when the rollup window is unavailable.","example":0.12},"VaultMetricsDisplay":{"type":["object","null"],"properties":{"sharpeRatio":{"type":["number","null"],"description":"Deprecated: `all.sharpeRatio`, held back until 30 live closes exist. Read `live` / `all` instead.","example":3.4091},"maxDrawdown":{"allOf":[{"$ref":"#/components/schemas/MetricRate"},{"description":"Deprecated: `all.maxDrawdown` (and its dates), held back until 30 live closes exist. Read `live` / `all` instead."}]},"maxDrawdownStart":{"type":["string","null"],"format":"date","example":"2024-11-15"},"maxDrawdownEnd":{"type":["string","null"],"format":"date","example":"2024-11-19"},"roi":{"type":["number","null"],"description":"Live all-time return, `latest live close / first live close - 1`. `roi7d` / `roi30d` / `roi90d` use the same live-only series with the opening on the first close at or after the cutoff, so a vault younger than the window reports its since-launch return. Each ROI requires two distinct live close dates in its selected period; otherwise it is null, never a zero standing in for missing history.","example":0.0821},"roi7d":{"type":["number","null"],"example":0.004484},"roi30d":{"type":["number","null"],"example":0.0091},"roi90d":{"type":["number","null"],"example":0.013424},"sharePrice":{"type":["number","null"],"minimum":0,"description":"Latest close on the continuous display basis in whole asset units, the line the main app charts. It is not re-based at offset events, so it can differ from the canonical `/v2/vault/{id}/share-price` value by a constant factor.","example":1.2805},"sharePrice24hChange":{"type":["number","null"],"description":"Null when no prior UTC day close exists. Never 0 as a stand-in.","example":0.0018},"sortino":{"type":["number","null"],"description":"Annualized Sortino over the trailing 90 live days: log returns in excess of a 3% risk-free rate over downside deviation. Null with fewer than two returns or no downside in the window.","example":5.12},"ytd":{"type":["number","null"],"description":"Live return since `ytdSince`. Null with fewer than two live close dates; `ytdSince` and `ytdSinceLaunch` are null with it.","example":0.0412},"ytdSince":{"type":["string","null"],"format":"date","description":"Opening close date of `ytd`: the last live close on or before December 31 of the prior year, or the first live close when none exists.","example":"2025-12-31"},"ytdSinceLaunch":{"type":["boolean","null"],"description":"True when `ytdSince` is the first live close because the vault has no live close before this year.","example":false},"seriesFrom":{"type":["string","null"],"format":"date","description":"First close of the display series. Earlier than `liveFrom` exactly when the vault has pre-launch history, i.e. when `all` differs from `live`.","example":"2026-07-19"},"liveFrom":{"type":["string","null"],"format":"date","description":"First observed on-chain day, the same date as `liveFrom` on `/share-price-display`.","example":"2026-09-23"},"live":{"$ref":"#/components/schemas/VaultMetricsDisplaySegment"},"all":{"$ref":"#/components/schemas/VaultMetricsDisplaySegment"}},"required":["sharpeRatio","maxDrawdown","maxDrawdownStart","maxDrawdownEnd","roi","roi7d","roi30d","roi90d","sharePrice","sharePrice24hChange","sortino","ytd","ytdSince","ytdSinceLaunch","seriesFrom","liveFrom","live","all"],"description":"Display-basis metrics for the main app vault page. Null until a rollup has materialized them for this vault. APR and risk metrics require their minimum history; ROI shortens to the available live period and requires two distinct close dates. All members are null without live observations or when a canonical tail cannot be calibrated or contains an adjacent-close move greater than 50%, including at the splice. The same move limit applies across the full on-chain series when no migrated display history exists."},"VaultMetricsDisplaySegment":{"type":["object","null"],"properties":{"roi":{"type":["number","null"],"description":"Return from the first to the latest close of the segment. Null with fewer than two distinct close dates.","example":3.86},"sharpeRatio":{"type":["number","null"],"description":"Annualized Sharpe over the segment: daily log returns in excess of a 3% risk-free rate over their sample deviation. Null until the segment has 30 closes.","example":5.59},"maxDrawdown":{"allOf":[{"$ref":"#/components/schemas/MetricRate"},{"description":"Deepest peak-to-trough fall inside the segment. Null until it has 30 closes."}]},"maxDrawdownStart":{"type":["string","null"],"format":"date","description":"UTC date of the peak.","example":"2026-08-02"},"maxDrawdownEnd":{"type":["string","null"],"format":"date","description":"UTC date of the trough.","example":"2026-08-05"},"apy":{"type":["number","null"],"description":"`(1 + roi)^(365 / days) - 1` over the calendar days from the segment’s first close to its latest close, null with `roi`. Any span is annualized, like the canonical `apy*` fields, so a short, sharp run reads as an extreme figure. `seriesFrom` / `liveFrom` identify the segment’s first close for deciding when to show `roi` instead.","example":0.214}},"required":["roi","sharpeRatio","maxDrawdown","maxDrawdownStart","maxDrawdownEnd","apy"],"description":"One segment of the display series, every member over the same closes. `live` runs from `liveFrom`, observed days only; `all` runs from `seriesFrom`, pre-launch track record included, and equals `live` without pre-launch history."},"MetricFeeSchedule":{"type":"object","properties":{"managementFeeBps":{"type":"number","minimum":0,"maximum":10000,"example":100},"performanceFeeBps":{"type":"number","minimum":0,"maximum":10000,"example":2000},"source":{"type":"string","enum":["bundle_state_current","external_vault"],"description":"bundle_state_current for on-chain vaults; external_vault when the vault has no chain state and its feed PPS is already net of venue fees, so both rates are 0 (ADR 0013).","example":"bundle_state_current"}},"required":["managementFeeBps","performanceFeeBps","source"]},"VaultMetricTvl":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"asset":{"$ref":"#/components/schemas/AnalyticsAsset"},"source":{"type":"string","enum":["bundle_state_current","pps_series"],"description":"bundle_state_current for on-chain vaults; pps_series when an external vault reports the total equity of its newest feed tick (ADR 0013).","example":"bundle_state_current"},"value":{"$ref":"#/components/schemas/TokenValue"}},"required":["asOf","asset","source","value"],"description":"Current token TVL from external_equity + underlying_balance, plus accrued_penalties for EVM. Every devnet asset uses a fixed $1.0 price. Mainnet USD uses the CoinGecko reference-price tick time (hourly series, 3-hour freshness window) and is omitted when no eligible preceding tick exists."},"VaultMetricsHistoryResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultMetricsHistoryData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultMetricsHistoryData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"granularity":{"type":"string","enum":["daily"],"example":"daily"},"metricSource":{"type":"string","enum":["bundle_metrics_daily"],"example":"bundle_metrics_daily"},"range":{"type":"object","properties":{"endDate":{"type":"string","format":"date","example":"2026-07-31"},"startDate":{"type":["string","null"],"format":"date","example":"2026-07-01"}},"required":["endDate","startDate"]},"rateUnit":{"type":"string","enum":["decimal"],"example":"decimal"},"scope":{"type":"string","enum":["ntbundle-program-vaults"],"description":"All Solana ntbundle-program vaults and EVM vaults present in bundle_registry are included; the scope string retains its compatibility spelling. catalog_visible is a payload hint and does not control authenticated API inclusion; retired legacy Drift-program vaults are excluded.","example":"ntbundle-program-vaults"},"series":{"type":"array","items":{"$ref":"#/components/schemas/VaultMetricsHistoryPoint"}},"vault":{"$ref":"#/components/schemas/BalanceVault"}},"required":["count","granularity","metricSource","range","rateUnit","scope","series","vault"]},"VaultMetricsHistoryPoint":{"type":"object","properties":{"apr7d":{"$ref":"#/components/schemas/MetricRate"},"apr30d":{"$ref":"#/components/schemas/MetricRate"},"apr90d":{"$ref":"#/components/schemas/MetricRate"},"aprInception":{"$ref":"#/components/schemas/MetricRate"},"apy7d":{"$ref":"#/components/schemas/MetricRate"},"apy30d":{"$ref":"#/components/schemas/MetricRate"},"apy90d":{"$ref":"#/components/schemas/MetricRate"},"apyInception":{"$ref":"#/components/schemas/MetricRate"},"date":{"type":"string","format":"date","example":"2026-07-21"},"maxDrawdown":{"$ref":"#/components/schemas/MetricRate"},"origin":{"type":"string","enum":["legacy-derived","rollup"],"description":"legacy-derived identifies a pre-seam row replayed from migrated daily PPS; rollup identifies a post-seam daily anchor. A post-seam row can still use migrated ticks in its fixed lookback windows.","example":"rollup"},"sharpeRatio30d":{"type":["number","null"],"example":1.42}},"required":["apr7d","apr30d","apr90d","aprInception","apy7d","apy30d","apy90d","apyInception","date","maxDrawdown","origin","sharpeRatio30d"]},"DepositSimulationResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/DepositSimulationData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"DepositSimulationData":{"type":"object","properties":{"asset":{"$ref":"#/components/schemas/BalanceAsset"},"assumptions":{"$ref":"#/components/schemas/SimulationAssumptions"},"calculatedAt":{"type":"integer","minimum":0,"example":1800000000},"currentPps":{"$ref":"#/components/schemas/TokenAmount"},"estimated":{"type":"boolean","enum":[true],"description":"Always true. This is a projection-derived preview and does not build or execute a transaction.","example":true},"timing":{"$ref":"#/components/schemas/SimulationTiming"},"totalAssets":{"$ref":"#/components/schemas/TokenAmount"},"totalShares":{"$ref":"#/components/schemas/TokenAmount"},"vault":{"$ref":"#/components/schemas/BalanceVault"},"amount":{"$ref":"#/components/schemas/TokenAmount"},"direction":{"type":"string","enum":["deposit"],"example":"deposit"},"expectedShares":{"$ref":"#/components/schemas/TokenAmount"},"fee":{"$ref":"#/components/schemas/SimulationFee"},"limits":{"$ref":"#/components/schemas/DepositSimulationLimits"},"netAmount":{"$ref":"#/components/schemas/TokenAmount"},"validation":{"$ref":"#/components/schemas/DepositSimulationValidation"}},"required":["asset","assumptions","calculatedAt","currentPps","estimated","timing","totalAssets","totalShares","vault","amount","direction","expectedShares","fee","limits","netAmount","validation"],"description":"Vault-level deposit preview at the current projected price. Expected shares use exact integer netting math but can drift before the request is actually netted."},"SimulationAssumptions":{"type":"object","properties":{"feeSource":{"type":"string","enum":["vault"],"description":"Vault-level fee configuration is used because this route has no user identity for fee overrides.","example":"vault"},"nettingPpsMayDrift":{"type":"boolean","description":"True when final deposit shares or withdrawal asset payouts can differ because price per share can move before netting or settlement.","example":true},"userStateValidated":{"type":"boolean","enum":[false],"description":"User balance, pending-request conflicts, deposit age, allowlist status, and user-specific fee or timing overrides are not validated.","example":false}},"required":["feeSource","nettingPpsMayDrift","userStateValidated"]},"SimulationTiming":{"type":"object","properties":{"cooldownEnd":{"type":["integer","null"],"minimum":0,"description":"Projected withdrawal eligibility timestamp in Unix seconds; null for a deposit.","example":1800003600},"cooldownSeconds":{"type":"integer","minimum":0,"example":3600},"etaProcessAt":{"type":["integer","null"],"minimum":0,"description":"Schedule-derived operational estimate, not a settlement promise. Null means the projected timing inputs are incomplete.","example":1800007200}},"required":["cooldownEnd","cooldownSeconds","etaProcessAt"]},"SimulationFee":{"type":"object","properties":{"amount":{"$ref":"#/components/schemas/TokenAmount"},"basisPoints":{"type":"integer","minimum":0,"maximum":5000,"example":25}},"required":["amount","basisPoints"]},"DepositSimulationLimits":{"type":"object","properties":{"currentAssets":{"$ref":"#/components/schemas/TokenAmount"},"maximumDepositAmount":{"$ref":"#/components/schemas/TokenAmount"},"maximumVaultCap":{"$ref":"#/components/schemas/TokenAmount"},"minimumDepositAmount":{"$ref":"#/components/schemas/TokenAmount"},"pendingDeposits":{"$ref":"#/components/schemas/TokenAmount"},"projectedAssets":{"$ref":"#/components/schemas/TokenAmount"},"remainingCapacity":{"$ref":"#/components/schemas/TokenAmount"}},"required":["currentAssets","maximumDepositAmount","maximumVaultCap","minimumDepositAmount","pendingDeposits","projectedAssets","remainingCapacity"],"description":"Capacity uses current assets plus all active requested deposit net amounts. The current program exposes one global ceiling as both maximumDepositAmount and maximumVaultCap; both projections are checked independently."},"DepositSimulationValidation":{"type":"object","properties":{"accepted":{"type":"boolean","example":true},"checks":{"$ref":"#/components/schemas/DepositSimulationChecks"},"rejectionReasons":{"type":"array","items":{"$ref":"#/components/schemas/SimulationRejectionReason"}}},"required":["accepted","checks","rejectionReasons"]},"DepositSimulationChecks":{"type":"object","properties":{"amountPositive":{"type":"boolean","example":true},"maximumDeposit":{"type":"boolean","example":true},"minimumDeposit":{"type":"boolean","example":true},"vaultCapacity":{"type":"boolean","example":true},"vaultOpen":{"type":"boolean","example":true}},"required":["amountPositive","maximumDeposit","minimumDeposit","vaultCapacity","vaultOpen"]},"SimulationRejectionReason":{"type":"object","properties":{"code":{"type":"string","enum":["DEPOSIT_AMOUNT_ZERO","MAX_CAP_EXCEEDED","MAX_DEPOSIT_AMOUNT_EXCEEDED","MIN_DEPOSIT_AMOUNT_NOT_MET","SHARES_EXCEED_VAULT_SUPPLY","VAULT_PAUSED","WITHDRAWAL_AMOUNT_ZERO","WITHDRAWAL_SHARES_ZERO"],"example":"MIN_DEPOSIT_AMOUNT_NOT_MET"},"message":{"type":"string","minLength":1,"example":"Deposit amount is below the projected vault minimum"}},"required":["code","message"]},"WithdrawalSimulationResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/WithdrawalSimulationData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"WithdrawalSimulationData":{"type":"object","properties":{"asset":{"$ref":"#/components/schemas/BalanceAsset"},"assumptions":{"$ref":"#/components/schemas/SimulationAssumptions"},"calculatedAt":{"type":"integer","minimum":0,"example":1800000000},"currentPps":{"$ref":"#/components/schemas/TokenAmount"},"estimated":{"type":"boolean","enum":[true],"description":"Always true. This is a projection-derived preview and does not build or execute a transaction.","example":true},"timing":{"$ref":"#/components/schemas/SimulationTiming"},"totalAssets":{"$ref":"#/components/schemas/TokenAmount"},"totalShares":{"$ref":"#/components/schemas/TokenAmount"},"vault":{"$ref":"#/components/schemas/BalanceVault"},"direction":{"type":"string","enum":["withdrawal"],"example":"withdrawal"},"fee":{"$ref":"#/components/schemas/SimulationFee"},"grossAmount":{"$ref":"#/components/schemas/TokenAmount"},"netAmount":{"$ref":"#/components/schemas/TokenAmount"},"shares":{"$ref":"#/components/schemas/TokenAmount"},"validation":{"$ref":"#/components/schemas/WithdrawalSimulationValidation"}},"required":["asset","assumptions","calculatedAt","currentPps","estimated","timing","totalAssets","totalShares","vault","direction","fee","grossAmount","netAmount","shares","validation"],"description":"Vault-level withdrawal preview using SDK share-to-assets math and the projected dynamic cooldown policy. Gross and net asset amounts use the current projected price per share and can drift before settlement."},"WithdrawalSimulationValidation":{"type":"object","properties":{"accepted":{"type":"boolean","example":true},"checks":{"$ref":"#/components/schemas/WithdrawalSimulationChecks"},"rejectionReasons":{"type":"array","items":{"$ref":"#/components/schemas/SimulationRejectionReason"}}},"required":["accepted","checks","rejectionReasons"]},"WithdrawalSimulationChecks":{"type":"object","properties":{"estimatedAmountPositive":{"type":"boolean","example":true},"sharesPositive":{"type":"boolean","example":true},"sharesWithinVaultSupply":{"type":"boolean","example":true},"vaultOpen":{"type":"boolean","example":true}},"required":["estimatedAmountPositive","sharesPositive","sharesWithinVaultSupply","vaultOpen"]},"SharePriceResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/SharePriceData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"SharePriceData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next newest-first tick page, or null on the final page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInZlcnNpb24iOjF9"},"pps":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Current lossless PPS from bundle_state_current.","example":"1074394"},"series":{"type":"array","items":{"$ref":"#/components/schemas/SharePriceTick"}},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["count","nextCursor","pps","series","vaultId"]},"SharePriceTick":{"type":"object","properties":{"blockTime":{"type":"integer","minimum":0,"example":1800000000},"isLegacy":{"type":"boolean","description":"True for a migrated daily-resolution legacy tick. Its slot is a synthetic ordering key, not a historical chain slot.","example":false},"pps":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1074394"},"signature":{"type":"string","minLength":1,"example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"slot":{"type":"integer","minimum":0,"description":"Solana slot for indexed ticks. Legacy ticks use a synthetic pre-boundary ordering key when the source retained no slot.","example":300000000},"sourceEvent":{"type":"string","minLength":1,"description":"Projection event or migration source that produced the PPS tick. EVM uses Deposit, RatePublished and evm_state_sample. Withdraw is a locked redemption payout, so its assets/shares ratio is not emitted as a PPS observation.","example":"NettingCompleted"},"totalEquity":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1074394000"},"totalShares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1000000000"}},"required":["blockTime","isLegacy","pps","signature","slot","sourceEvent","totalEquity","totalShares"]},"SharePriceDisplayResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/SharePriceDisplayData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"SharePriceDisplayData":{"type":"object","properties":{"basis":{"type":"string","enum":["display"],"description":"Marks the series as the non-canonical display basis: pre-launch days included, never re-based at offset events.","example":"display"},"count":{"type":"integer","minimum":0,"example":1},"liveFrom":{"type":["string","null"],"format":"date","description":"First observed UTC day. Every earlier point is pre-launch history; its phase says whether it was a backtest or really run. Null when the series is withheld.","example":"2026-04-23"},"series":{"type":"array","items":{"$ref":"#/components/schemas/SharePriceDisplayPoint"},"description":"One point per UTC day with no gaps, oldest first."},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["basis","count","liveFrom","series","vaultId"]},"SharePriceDisplayPoint":{"type":"object","properties":{"carried":{"type":"boolean","description":"True when no close was observed for this UTC day and the previous one was carried forward, so the day is a flat continuation rather than a reading. Draw it dashed to distinguish the two.","example":false},"date":{"type":"string","format":"date","example":"2026-07-01"},"phase":{"type":"string","enum":["backtest","pre-neutral","live"],"description":"live from liveFrom on. Earlier days are pre-launch history: backtest when simulated, pre-neutral when the curator really ran the strategy before launching it on Neutral.","example":"live"},"sharePrice":{"type":"number","minimum":0,"description":"Close for the UTC day in whole asset units on the continuous display basis.","example":1.0744}},"required":["carried","date","phase","sharePrice"]},"VaultSnapshotsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultSnapshotsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultSnapshotsData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next newest-first daily snapshot page, or null on the final page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMSIsInZlcnNpb24iOjF9"},"snapshots":{"type":"array","items":{"$ref":"#/components/schemas/VaultSnapshot"}},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["count","nextCursor","snapshots","vaultId"]},"VaultSnapshot":{"type":"object","properties":{"closePps":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1074394"},"closeTotalShares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1000000000"},"closeTvlToken":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1074394000"},"closeTvlUsd":{"type":"number","description":"USD close TVL. Present exactly when priceUsd and priceAsOf are both present.","example":1074.394},"date":{"type":"string","format":"date","example":"2026-07-21"},"fees":{"$ref":"#/components/schemas/VaultSnapshotFees"},"flows":{"$ref":"#/components/schemas/VaultSnapshotFlows"},"isLegacy":{"type":"boolean","description":"True for migrated legacy history. Legacy rows have daily resolution and can inherit the documented legacy USD $1.0 fallback.","example":true},"method":{"type":"string","enum":["close","legacy-mean"],"description":"close uses the final available PPS tick for the UTC day; legacy-mean identifies an older migrated day-mean source.","example":"close"},"priceAsOf":{"type":"integer","minimum":0,"description":"Unix timestamp of priceUsd. Present exactly when closeTvlUsd and priceUsd are both present.","example":1800000000},"priceUsd":{"type":"number","description":"Token USD price used for closeTvlUsd. Present exactly when closeTvlUsd and priceAsOf are both present.","example":1}},"required":["closePps","closeTotalShares","closeTvlToken","date","fees","flows","isLegacy","method"]},"VaultSnapshotFees":{"type":"object","properties":{"mgmtChargedValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Management fees valued when charged to users. Omitted only on canonical history that has not yet received the fee-split backfill.","example":"1000"},"mgmtCollectedValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Management fees valued when collected through manager withdrawals. Omitted only on canonical history that has not yet received the fee-split backfill.","example":"250"},"mgmtValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Compatibility total combining mgmtChargedValue and mgmtCollectedValue. It contains both fee lifecycle stages.","example":"1250"},"perfChargedValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Performance fees valued when charged to users. Omitted only on canonical history that has not yet received the fee-split backfill.","example":"4000"},"perfCollectedValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Performance fees valued when collected through manager withdrawals. Omitted only on canonical history that has not yet received the fee-split backfill.","example":"1000"},"perfValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Compatibility total combining perfChargedValue and perfCollectedValue. It contains both fee lifecycle stages.","example":"5000"},"referralMfeeValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"125"},"referralPfeeValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"500"}},"required":["mgmtValue","perfValue","referralMfeeValue","referralPfeeValue"]},"VaultSnapshotFlows":{"type":"object","properties":{"transferIn":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"transferOut":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"depositProcessed":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"depositRefunded":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"depositRequested":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"switchIn":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"switchOut":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"withdrawalProcessed":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"},"withdrawalRequested":{"$ref":"#/components/schemas/VaultDailyFlowAggregate"}},"required":["depositProcessed","depositRefunded","depositRequested","switchIn","switchOut","withdrawalProcessed","withdrawalRequested"]},"VaultDailyFlowAggregate":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":2},"fee":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"2000"},"gross":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"2000000"},"net":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1998000"}},"required":["count","fee","gross","net"]},"VaultUsersResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultUsersData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultUsersData":{"type":"object","properties":{"aggregates":{"$ref":"#/components/schemas/VaultUsersAggregates"},"nextCursor":{"type":["string","null"],"minLength":1,"description":"Opaque cursor for the next newest-first cohort page, or null at the end.","example":"eyJ2IjoxLCJmaXJzdERlcG9zaXRBdCI6MTgwMDAwMDAwMCwid2FsbGV0IjoiR2dCYUNzM05wZUVKN1loVnRRekU5cnF3RzVhelNNUG1OSnlkSlZKczJlOTIifQ"},"users":{"type":"array","items":{"$ref":"#/components/schemas/VaultUser"}},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["nextCursor","users","vaultId"]},"VaultUsersAggregates":{"type":"object","properties":{"holderCount":{"type":"integer","minimum":0,"description":"Count of active wallets with shares greater than zero.","example":12},"top5Concentration":{"type":"number","minimum":0,"maximum":1,"description":"Decimal share of all active holder shares owned by the five largest holders; 1 means 100%.","example":0.72},"top10Concentration":{"type":"number","minimum":0,"maximum":1,"description":"Decimal share of all active holder shares owned by the ten largest holders; 1 means 100%.","example":0.91}},"required":["holderCount","top5Concentration","top10Concentration"]},"VaultUser":{"type":"object","properties":{"effectiveFees":{"$ref":"#/components/schemas/EffectiveFees"},"feeOverrides":{"$ref":"#/components/schemas/FeeOverrides"},"feesPaid":{"allOf":[{"$ref":"#/components/schemas/TokenAmount"},{"type":["object","null"]}]},"firstDepositAt":{"type":"integer","minimum":0,"example":1700000000},"hasPendingRequest":{"type":"boolean","description":"True when the wallet has a requested or netted deposit or withdrawal for this vault.","example":true},"hwmPerShare":{"allOf":[{"$ref":"#/components/schemas/TokenAmount"},{"type":["object","null"]}]},"lastFeeChargedAt":{"type":["integer","null"],"minimum":0,"description":"Unix timestamp of the latest projected fee charge, or null when absent.","example":1799000000},"netDeposits":{"$ref":"#/components/schemas/SignedTokenAmount"},"referrer":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}],"description":"Current projected referrer attribution, or null when the wallet is unattributed.","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"shares":{"$ref":"#/components/schemas/TokenAmount"},"value":{"allOf":[{"$ref":"#/components/schemas/TokenValue"},{"description":"Current position value calculated from projected shares × vault PPS."}]},"wallet":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["effectiveFees","feeOverrides","feesPaid","firstDepositAt","hasPendingRequest","hwmPerShare","lastFeeChargedAt","netDeposits","referrer","shares","value","wallet"]},"EffectiveFees":{"type":"object","properties":{"depositFeeBps":{"type":"number","minimum":0,"maximum":4294967295,"example":100},"withdrawalFeeBps":{"type":"number","minimum":0,"maximum":4294967295,"example":100},"performanceFeeBps":{"type":"number","minimum":0,"maximum":4294967295,"example":100},"managementFeeBps":{"type":"number","minimum":0,"maximum":4294967295,"example":100}},"required":["depositFeeBps","withdrawalFeeBps","performanceFeeBps","managementFeeBps"]},"FeeOverrides":{"type":["object","null"],"properties":{"flags":{"type":"integer","minimum":0,"maximum":255,"example":5},"depositFeeBps":{"type":["number","null"],"minimum":0,"maximum":4294967295,"example":100},"withdrawalFeeBps":{"type":["number","null"],"minimum":0,"maximum":4294967295,"example":100},"performanceFeeBps":{"type":["number","null"],"minimum":0,"maximum":4294967295,"example":100},"managementFeeBps":{"type":["number","null"],"minimum":0,"maximum":4294967295,"example":100}},"required":["flags","depositFeeBps","withdrawalFeeBps","performanceFeeBps","managementFeeBps"],"description":"Projected per-user fee overrides. Null means no override flag is active; each unflagged fee component is null."},"SignedTokenAmount":{"type":"object","properties":{"raw":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","example":"-123450000"},"token":{"type":"string","pattern":"^(?:0|-?(?:0\\.\\d*[1-9]|[1-9]\\d*(?:\\.\\d*[1-9])?))$","example":"-123.45"}},"required":["raw","token"]},"UserActionsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/UserActionsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true},"asOfScope":{"type":"string","enum":["global","vault"],"description":"Scope of the asOf cursor. Vault is used when that vault has current projection state; global is used by the cross-vault route and as the fallback for retired legacy vaults.","example":"global"}},"required":["asOf","data","success","asOfScope"]},"UserActionsData":{"type":"object","properties":{"actions":{"type":"array","items":{"$ref":"#/components/schemas/UserAction"}},"count":{"type":"integer","minimum":0,"example":1},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next newest-first page, or null on the final page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInZlcnNpb24iOjF9"}},"required":["actions","count","nextCursor"]},"UserAction":{"type":"object","properties":{"blockTime":{"type":"integer","minimum":0,"example":1800000000},"chain":{"$ref":"#/components/schemas/ChainId"},"fee":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1000000"},"flowType":{"$ref":"#/components/schemas/UserFlowType"},"gross":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1000000"},"net":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1000000"},"origin":{"type":"string","enum":["indexed","legacy"],"example":"indexed"},"sharePrice":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1000000"},"sharesDelta":{"type":["string","null"],"pattern":"^(?:0|-?[1-9]\\d*)$","example":"-1000000"},"signature":{"type":"string","minLength":1,"description":"Explorer-linkable Solana signature or EVM transaction hash","example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"source":{"type":"string","minLength":1,"description":"Event or attribution source memo","example":"DepositProcessed"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["blockTime","fee","flowType","gross","net","origin","sharePrice","sharesDelta","signature","source","vaultId"]},"UserFlowType":{"type":"string","enum":["deposit_requested","deposit_processed","deposit_refunded","withdrawal_requested","withdrawal_processed","switch_out","switch_in","transfer_out","transfer_in","fee_charged","referrer_fee_accrued","referrer_payout","account_closed","dust_burned","token_minted"],"example":"deposit_processed","description":"User activity type. token_minted records a wallet's instant mint of a Solana bundle's receipt tokens: assets enter the bundle, whose share-token pool holds the shares, so the wallet's position does not change. transfer_in receives EVM vault shares and adds their value at the latest available transfer-time PPS to net deposits; it also records Solana receipt-token redemption importing pool shares into the user's position at the redemption-time value. transfer_out sends EVM vault shares and subtracts their transfer-time value. EVM wallet-to-wallet movements do not deposit or withdraw vault assets."},"VaultUserFeesResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultUserFeesData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true},"asOfScope":{"type":"string","enum":["global","vault"],"description":"Scope of the asOf cursor. Vault is used when that vault has current projection state; global is used by the cross-vault route and as the fallback for retired legacy vaults.","example":"global"}},"required":["asOf","data","success","asOfScope"]},"VaultUserFeesData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"fees":{"type":"array","items":{"$ref":"#/components/schemas/UserFee"}},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next newest-first merged page, or null on the final page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsImluZGV4V2l0aGluQmxvY2siOjMsIml4SW5kZXgiOjEsImtpbmQiOiJwZXJmIiwib3JpZ2luIjoiaW5kZXhlZCIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInNsb3QiOjMwMDAwMDAwMCwidmF1bHRJZCI6IjJiUGlOZkdjN2V4VWNHa3ZWNW5ic1NrdU5IM2luRlUxOGtnTkVrQjhmaWFUIiwidmVyc2lvbiI6MX0"},"totals":{"$ref":"#/components/schemas/VaultUserFeeTotals"}},"required":["count","fees","nextCursor","totals"]},"UserFee":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1200000","description":"Fee amount in settlement-time token minor units."},"blockTime":{"type":"integer","minimum":0,"example":1800000000},"kind":{"type":["string","null"],"enum":["mgmt","perf",null],"example":"perf"},"origin":{"type":"string","enum":["indexed","legacy"],"example":"indexed"},"referralMfeeBps":{"type":["integer","null"],"minimum":0,"maximum":4294967295,"example":500},"referralPfeeBps":{"type":["integer","null"],"minimum":0,"maximum":4294967295,"example":500},"referralTierIndex":{"type":["integer","null"],"minimum":0,"maximum":255,"example":1},"sharePrice":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1025000","description":"Exact onchain PPS at which an indexed charge settled; null for legacy rows."},"shares":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"1170731","description":"Fee shares burned for an indexed charge; null for legacy rows."},"signature":{"type":"string","minLength":1,"description":"Explorer-linkable Solana signature","example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["amount","blockTime","kind","origin","referralMfeeBps","referralPfeeBps","referralTierIndex","sharePrice","shares","signature","vaultId"]},"VaultUserFeeTotals":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":5},"legacy":{"$ref":"#/components/schemas/UserFeeLegacyTotals"},"mgmt":{"$ref":"#/components/schemas/UserFeeComponentTotals"},"perf":{"$ref":"#/components/schemas/UserFeeComponentTotals"}},"required":["count","legacy","mgmt","perf"]},"UserFeeLegacyTotals":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"500000"},"count":{"type":"integer","minimum":0,"example":2}},"required":["amount","count"]},"UserFeeComponentTotals":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1500000"},"shares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1463414"}},"required":["amount","shares"]},"UnsupportedChainResponse":{"allOf":[{"$ref":"#/components/schemas/ErrorResponse"},{"type":"object","properties":{"chain":{"$ref":"#/components/schemas/ChainId"}}}]},"UserFeesResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/UserFeesData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true},"asOfScope":{"type":"string","enum":["global","vault"],"description":"Scope of the asOf cursor. Vault is used when that vault has current projection state; global is used by the cross-vault route and as the fallback for retired legacy vaults.","example":"global"}},"required":["asOf","data","success","asOfScope"]},"UserFeesData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"fees":{"type":"array","items":{"$ref":"#/components/schemas/UserFee"}},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next newest-first merged page, or null on the final page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsImluZGV4V2l0aGluQmxvY2siOjMsIml4SW5kZXgiOjEsImtpbmQiOiJwZXJmIiwib3JpZ2luIjoiaW5kZXhlZCIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInNsb3QiOjMwMDAwMDAwMCwidmF1bHRJZCI6IjJiUGlOZkdjN2V4VWNHa3ZWNW5ic1NrdU5IM2luRlUxOGtnTkVrQjhmaWFUIiwidmVyc2lvbiI6MX0"},"totals":{"type":"array","items":{"$ref":"#/components/schemas/CrossVaultUserFeeTotals"}}},"required":["count","fees","nextCursor","totals"]},"CrossVaultUserFeeTotals":{"type":"object","properties":{"legacy":{"$ref":"#/components/schemas/UserFeeLegacyTotals"},"mgmt":{"$ref":"#/components/schemas/UserFeeComponentTotals"},"perf":{"$ref":"#/components/schemas/UserFeeComponentTotals"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["legacy","mgmt","perf","vaultId"]},"ReferrerSummaryResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/ReferrerSummaryData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"ReferrerSummaryData":{"type":"object","properties":{"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"bundles":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerBundleSummary"}},"totals":{"type":"object","properties":{"attributedUserCount":{"type":"integer","minimum":0,"example":128},"claimableUsd":{"type":["number","null"],"minimum":0,"example":742.31},"attributedTvlUsd":{"type":["number","null"],"minimum":0,"example":125430.72},"referredNetDeposits":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","description":"Arithmetic sum of per-vault referredNetDeposits minor-unit values. Use each vault value for tier progress; this total is not mark-to-market attributed TVL.","example":"12500000000"}},"required":["attributedUserCount","claimableUsd","attributedTvlUsd","referredNetDeposits"]}},"required":["referrer","bundles","totals"]},"ReferrerBundleSummary":{"type":"object","properties":{"vaultId":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"active":{"type":"boolean","example":true},"asset":{"type":"object","properties":{"mint":{"type":["string","null"],"pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"decimals":{"type":["integer","null"],"minimum":0,"maximum":18,"example":6},"priceUsd":{"type":["number","null"],"exclusiveMinimum":0,"example":1.001},"priceAsOf":{"type":["integer","null"],"minimum":0,"example":1800000000}},"required":["mint","decimals","priceUsd","priceAsOf"]},"accruedShares":{"type":"object","properties":{"pfee":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1250000"},"mfee":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"250000"},"total":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1500000"}},"required":["pfee","mfee","total"]},"pps":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1012500"},"claimable":{"$ref":"#/components/schemas/ReferrerValue"},"pendingWithdrawal":{"$ref":"#/components/schemas/ReferrerPendingWithdrawal"},"attributedUserCount":{"type":"integer","minimum":0,"example":42},"attributedTvl":{"$ref":"#/components/schemas/ReferrerValue"},"referredNetDeposits":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","description":"Signed net deposited capital in this vault’s token minor unit since referral-tier tracking was enabled. Pre-existing referrers start at 0, withdrawals can make it negative, and it is distinct from mark-to-market attributedTvl.","example":"7500000000"},"currentTier":{"$ref":"#/components/schemas/ReferrerCurrentTier"},"nextTier":{"$ref":"#/components/schemas/ReferrerNextTier"},"asOf":{"$ref":"#/components/schemas/AsOf"}},"required":["vaultId","active","asset","accruedShares","pps","claimable","pendingWithdrawal","attributedUserCount","attributedTvl","referredNetDeposits","currentTier","nextTier","asOf"]},"ReferrerValue":{"type":"object","properties":{"raw":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","example":"123450000"},"token":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d+)?$","example":"123.45"},"usd":{"type":["number","null"],"minimum":0,"example":123.57}},"required":["raw","token","usd"]},"ReferrerPendingWithdrawal":{"type":["object","null"],"properties":{"shares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"25000000"},"estimatedValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"25250000"},"cooldownEnd":{"type":"integer","minimum":0,"example":1800086400}},"required":["shares","estimatedValue","cooldownEnd"]},"ReferrerCurrentTier":{"type":["object","null"],"properties":{"index":{"type":"integer","minimum":0,"maximum":4,"example":1},"pfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"example":1000},"mfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"example":500}},"required":["index","pfeeBps","mfeeBps"],"description":"The schedule tier reached by referredNetDeposits, or null below the first tier."},"ReferrerNextTier":{"type":["object","null"],"properties":{"threshold":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"10000000000"},"remaining":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"2500000000"}},"required":["threshold","remaining"],"description":"The next schedule threshold and exact additional net deposits required, or null at the highest tier or for an empty schedule."},"ReferrerPayoutResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/ReferrerPayoutData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"ReferrerPayoutData":{"type":"object","properties":{"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"payouts":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerPayout"}},"totals":{"$ref":"#/components/schemas/ReferrerPayoutTotals"},"nextCursor":{"type":["string","null"],"minLength":1,"description":"Opaque cursor for the next newest-first payout page, or null at the end.","example":"eyJ2IjoxLCJibG9ja1RpbWUiOjE4MDAwMDAwMDAsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsImV2ZW50SW5kZXgiOjJ9"}},"required":["referrer","payouts","totals","nextCursor"]},"ReferrerPayout":{"type":"object","properties":{"vaultId":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"sharesRedeemed":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1500000"},"redemptionAmount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1518750"},"signature":{"type":"string","minLength":1,"example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"signatureUrl":{"type":"string","format":"uri","example":"https://solscan.io/tx/5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"},"slot":{"type":"integer","minimum":0,"example":300000000},"eventIndex":{"type":"integer","minimum":0,"example":2},"blockTime":{"type":"integer","minimum":0,"example":1800000000}},"required":["vaultId","sharesRedeemed","redemptionAmount","signature","signatureUrl","slot","eventIndex","blockTime"]},"ReferrerPayoutTotals":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"description":"All-time count of settled referrer withdrawals across every vault.","example":5},"redemptionUsd":{"type":["number","null"],"minimum":0,"description":"Current USD value of every per-vault settled token total, or null when any contributing vault lacks asset metadata or a non-stale price.","example":3713.84},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerPayoutVaultTotal"},"description":"All-time settled token totals grouped by vault so unlike token assets are never added together.","example":[]}},"required":["count","redemptionUsd","vaults"]},"ReferrerPayoutVaultTotal":{"type":"object","properties":{"vaultId":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"asset":{"type":"object","properties":{"mint":{"type":["string","null"],"pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"decimals":{"type":["integer","null"],"minimum":0,"maximum":18,"example":6},"priceUsd":{"type":["number","null"],"exclusiveMinimum":0,"example":1.001},"priceAsOf":{"type":["integer","null"],"minimum":0,"example":1800000000}},"required":["mint","decimals","priceUsd","priceAsOf"]},"count":{"type":"integer","minimum":0,"example":5},"sharesRedeemed":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"1500000"},"redemption":{"$ref":"#/components/schemas/ReferrerValue"}},"required":["vaultId","asset","count","sharesRedeemed","redemption"]},"ReferrerHistoryResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/ReferrerHistoryData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"ReferrerHistoryData":{"type":"object","properties":{"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"count":{"type":"integer","minimum":0,"example":31},"history":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerHistoryPoint"}},"nextCursor":{"type":["string","null"],"minLength":1,"description":"Opaque cursor for the next chronological page, or null on the final page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMiIsInZlcnNpb24iOjF9"},"range":{"type":"object","properties":{"from":{"type":["string","null"],"format":"date","example":"2026-07-01"},"to":{"type":"string","format":"date","example":"2026-07-31"}},"required":["from","to"]},"throughDate":{"type":"string","format":"date","description":"Newest completed UTC date covered by the referrer_daily watermark.","example":"2026-07-31"},"partialThrough":{"type":["string","null"],"format":"date-time","description":"Rollup pass start time the partial point is current as of; all chain activity ingested before this instant is folded, while ingest lag can trail by seconds. Null when this page contains no partial point.","example":"2026-08-01T00:10:00.000Z"}},"required":["referrer","count","history","nextCursor","range","throughDate","partialThrough"]},"ReferrerHistoryPoint":{"type":"object","properties":{"date":{"type":"string","format":"date","example":"2026-07-22"},"partial":{"type":"boolean","description":"True when this UTC date is newer than throughDate and remains provisional. Clients must treat an absent field from older API deployments as false.","example":false},"totals":{"type":"object","properties":{"earningsUsd":{"type":["number","null"],"minimum":0,"description":"Earnings attributed on this UTC date, valued at each vault’s close price. This is a daily delta, not a cumulative snapshot.","example":1.52},"earningsCumulativeUsd":{"type":["number","null"],"minimum":0,"description":"Inception-to-date sum of daily earnings through this point, independent of date filters and cursor pages. Null when any non-zero earning in the prefix lacks USD valuation. This is a cumulative snapshot; do not sum it across points.","example":742.31},"attributedTvlUsd":{"type":["number","null"],"minimum":0,"example":125430.72},"depositNetUsd":{"type":["number","null"],"minimum":0,"example":500.25},"withdrawalNetUsd":{"type":["number","null"],"minimum":0,"example":100.1},"payoutUsd":{"type":["number","null"],"minimum":0,"example":1.51}},"required":["earningsUsd","earningsCumulativeUsd","attributedTvlUsd","depositNetUsd","withdrawalNetUsd","payoutUsd"]},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerHistoryVaultPoint"}}},"required":["date","partial","totals","vaults"]},"ReferrerHistoryVaultPoint":{"type":"object","properties":{"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"origin":{"type":"string","enum":["rollup"],"example":"rollup"},"asset":{"type":"object","properties":{"mint":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"decimals":{"type":"integer","minimum":0,"maximum":18,"example":6},"priceUsd":{"type":["number","null"],"exclusiveMinimum":0,"example":1.001},"priceAsOf":{"type":["integer","null"],"minimum":0,"example":1800000000}},"required":["mint","decimals","priceUsd","priceAsOf"]},"asOf":{"$ref":"#/components/schemas/AsOf"},"pps":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1012500"},"attributedUserCount":{"type":"integer","minimum":0,"description":"Number of users attributed to this referrer and vault at the UTC-day close.","example":42},"referredNetDeposits":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","description":"Program-authored signed referred-net-deposit counter at the UTC-day close, in this vault asset’s token minor unit. This is the counter used for referral-tier placement.","example":"7500000000"},"earnings":{"type":"object","properties":{"shares":{"type":"object","properties":{"pfee":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1250000"},"mfee":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"250000"},"total":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1500000"}},"required":["pfee","mfee","total"]},"value":{"type":"object","properties":{"pfee":{"$ref":"#/components/schemas/ReferrerHistoryValue"},"mfee":{"$ref":"#/components/schemas/ReferrerHistoryValue"},"total":{"$ref":"#/components/schemas/ReferrerHistoryValue"}},"required":["pfee","mfee","total"]}},"required":["shares","value"]},"attributed":{"type":"object","properties":{"closeShares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1000000000"},"tvl":{"$ref":"#/components/schemas/ReferrerHistoryValue"},"flows":{"type":"object","properties":{"deposits":{"$ref":"#/components/schemas/ReferrerHistoryFlowAggregate"},"withdrawals":{"$ref":"#/components/schemas/ReferrerHistoryFlowAggregate"}},"required":["deposits","withdrawals"]}},"required":["closeShares","tvl","flows"]},"payouts":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"sharesRedeemed":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1500000"},"redemption":{"$ref":"#/components/schemas/ReferrerHistoryValue"}},"required":["count","sharesRedeemed","redemption"]}},"required":["vaultId","bundleKey","origin","asset","asOf","pps","attributedUserCount","referredNetDeposits","earnings","attributed","payouts"]},"ReferrerHistoryValue":{"type":"object","properties":{"raw":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless amount in the token minor unit encoded as a decimal string.","example":"1250000"},"token":{"type":"string","pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d+)?$","description":"Exact decimal rendering in whole token units.","example":"1.25"},"usd":{"type":["number","null"],"minimum":0,"description":"USD value at the day close price, or null with every other USD value for this vault day when price data is unavailable.","example":1.25125}},"required":["raw","token","usd"]},"ReferrerHistoryFlowAggregate":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":2},"gross":{"$ref":"#/components/schemas/ReferrerHistoryValue"},"fee":{"$ref":"#/components/schemas/ReferrerHistoryValue"},"net":{"$ref":"#/components/schemas/ReferrerHistoryValue"}},"required":["count","gross","fee","net"]},"ReferrerUsersResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/ReferrerUsersData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"ReferrerUsersData":{"type":"object","properties":{"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"users":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerUser"}},"nextCursor":{"type":["string","null"],"minLength":1,"description":"Opaque cursor for the next vault-and-user-ordered cohort page, or null at the end.","example":"eyJ2IjoxLCJidW5kbGVLZXkiOiIyYlBpTmZHYzdleFVjR2t2VjVuYnNTa3VOSDNpbkZVMThrZ05Fa0I4ZmlhVCIsInVzZXIiOiJHZ0JhQ3MzTnBlRUo3WWhWdFF6RTlycXdHNWF6U01QbU5KeWRKVkpzMmU5MiJ9"}},"required":["referrer","users","nextCursor"]},"ReferrerUser":{"type":"object","properties":{"user":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"vaultId":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"shares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","example":"25000000"},"netDeposits":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","example":"24500000"},"firstDepositAt":{"type":"integer","minimum":0,"example":1799913600},"referralPfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Historical performance-fee referral rate recorded when this user bound the referrer. This is not the current live settlement rate.","example":1000},"referralMfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Historical management-fee referral rate recorded when this user bound the referrer. This is not the current live settlement rate.","example":500}},"required":["user","vaultId","shares","netDeposits","firstDepositAt","referralPfeeBps","referralMfeeBps"]},"ReferrerFlowsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/ReferrerFlowsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"ReferrerFlowsData":{"type":"object","properties":{"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"flows":{"type":"array","items":{"$ref":"#/components/schemas/ReferrerFlow"}},"nextCursor":{"type":["string","null"],"minLength":1,"description":"Opaque cursor for the next newest-first attributed-flow page, or null at the end.","example":"eyJ2IjoxLCJibG9ja1RpbWUiOjE4MDAwMDAwMDAsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsImV2ZW50SW5kZXgiOjIsInVzZXIiOiJHZ0JhQ3MzTnBlRUo3WWhWdFF6RTlycXdHNWF6U01QbU5KeWRKVkpzMmU5MiIsImZsb3dUeXBlIjoiZGVwb3NpdF9wcm9jZXNzZWQifQ"}},"required":["referrer","flows","nextCursor"]},"ReferrerFlow":{"allOf":[{"$ref":"#/components/schemas/UserAction"},{"type":"object","properties":{"user":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["user"]}]},"PartnerAgreementsResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/PartnerAgreementsData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"PartnerAgreementsData":{"type":"object","properties":{"agreements":{"type":"array","items":{"$ref":"#/components/schemas/PartnerAgreementState"},"example":[]},"partnerId":{"type":"string","example":"acme-payments"}},"required":["agreements","partnerId"]},"PartnerAgreementState":{"type":"object","properties":{"active":{"type":"boolean","description":"Whether this registered referrer can accept future binds. False when the referrer is unregistered or its per-referrer kill switch is disabled.","example":true},"asOf":{"allOf":[{"$ref":"#/components/schemas/AsOf"},{"description":"Newest Solana projection cursor contributing to this agreement row."}]},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"defaultMfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"deprecated":true,"description":"Deprecated flat bundle management-fee compatibility value. It does not participate in live effective-rate resolution.","example":500},"defaultPfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"deprecated":true,"description":"Deprecated flat bundle performance-fee compatibility value. It does not participate in live effective-rate resolution.","example":1000},"effectiveMfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Current live management-fee referral rate: the referrer override when bit 1 is set, otherwise the tier resolved from referred net deposits.","example":500},"effectivePfeeBps":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Current live performance-fee referral rate: the referrer override when bit 0 is set, otherwise the tier resolved from referred net deposits.","example":1250},"rateOverrideFlags":{"type":"integer","minimum":0,"maximum":255,"description":"Referrer override bitset. Bit 0 selects the performance-fee override and bit 1 selects the management-fee override. Unregistered referrers return 0.","example":1},"referrer":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"referrerEnabled":{"type":"boolean","description":"Whether referral accrual is enabled at the bundle level.","example":true},"referrerMinDepositAmount":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Exact token minor-unit minimum deposit for referral eligibility. Apply the bundle asset decimals for display.","example":"5000000"},"registered":{"type":"boolean","description":"Whether a projected ReferrerAccount exists for this referrer and bundle.","example":true}},"required":["active","asOf","bundleKey","defaultMfeeBps","defaultPfeeBps","effectiveMfeeBps","effectivePfeeBps","rateOverrideFlags","referrer","referrerEnabled","referrerMinDepositAmount","registered"]},"VaultPendingResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultPendingData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultPendingData":{"type":"object","properties":{"aggregate":{"$ref":"#/components/schemas/VaultPendingAggregate"},"count":{"type":"integer","minimum":0,"example":50},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next newest-first page, or null on the final page.","example":"eyJkaXJlY3Rpb24iOiJkZXBvc2l0IiwiZmlyc3RSZXF1ZXN0U2lnbmF0dXJlIjoiNVZFUnY4Tk05enFQanF4Sk1FNWEzdVc2UzlKbnZHOTZOMmlKejZlUjRWcVduVFFrM3NZcDhjTDFoRjdkQjJtSzV4QTl1QzRyRTZ0RzNqSDh3UDFvWjdzIiwicmVxdWVzdGVkQXQiOjE4MDAwMDAwMDAsInVzZXIiOiJHZ0JhQ3MzTnBlRUo3WWhWdFF6RTlycXdHNWF6U01QbU5KeWRKVkpzMmU5MiIsInZlcnNpb24iOjF9"},"requests":{"type":"array","items":{"$ref":"#/components/schemas/VaultPendingRequest"}},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["aggregate","count","nextCursor","requests","vaultId"]},"VaultPendingAggregate":{"type":"object","properties":{"deposit":{"type":"object","properties":{"netted":{"$ref":"#/components/schemas/VaultPendingAggregateBucket"},"requested":{"$ref":"#/components/schemas/VaultPendingAggregateBucket"}},"required":["netted","requested"]},"withdrawal":{"type":"object","properties":{"netted":{"$ref":"#/components/schemas/VaultPendingAggregateBucket"},"requested":{"$ref":"#/components/schemas/VaultPendingAggregateBucket"}},"required":["netted","requested"]}},"required":["deposit","withdrawal"],"description":"Direction-by-stage totals for the complete filtered queue; cursor and limit never change this block."},"VaultPendingAggregateBucket":{"type":"object","properties":{"amounts":{"$ref":"#/components/schemas/PendingAmounts"},"count":{"type":"integer","minimum":0,"example":12},"degradedCount":{"type":"integer","minimum":0,"example":1}},"required":["amounts","count","degradedCount"]},"PendingAmounts":{"type":"object","properties":{"estimatedValue":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"101250000"},"fee":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"100000"},"gross":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"100000000"},"net":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"99900000"},"shares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"98765432"}},"description":"Lossless sums over the full filtered bucket. A component is omitted if any row in the bucket lacks it, so degraded vintage rows never produce a misleading partial sum."},"VaultPendingRequest":{"type":"object","properties":{"amounts":{"$ref":"#/components/schemas/PendingAmounts"},"claimableAssets":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"1000000000000000000"},"cooldownEnd":{"type":["integer","null"],"minimum":0,"description":"Withdrawal eligibility timestamp in Unix seconds; null for deposits or incomplete historical requests.","example":1800086400},"degraded":{"type":"boolean","enum":[true],"description":"True when the projected request lacks fields required for a complete amount or timing view.","example":true},"degradation":{"$ref":"#/components/schemas/PendingDegradation"},"direction":{"type":"string","enum":["deposit","withdrawal"],"example":"deposit"},"etaProcessAt":{"type":["integer","null"],"minimum":0,"description":"Estimated processing timestamp in Unix seconds, or null when required vintage timing fields or vault schedule inputs are incomplete.","example":1800090000},"etaReason":{"type":"string","enum":["evm_manager_settles"],"example":"evm_manager_settles"},"requestedAt":{"type":"integer","minimum":0,"example":1800000000},"requestId":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","description":"EVM on-chain request ID when the controller pool contains one distinct ID; null for multiple IDs. IDs can be reused.","example":"0"},"requestIds":{"type":"array","items":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"0"},"example":["0"],"description":"Distinct EVM request IDs contributing to this controller pool. Payout amounts are pooled, not attributed to individual IDs."},"stage":{"type":"string","enum":["requested","netted"],"example":"requested"},"switchTargetBundle":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Target bundle for an in-flight bundle-switch withdrawal, when applicable.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"user":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["amounts","cooldownEnd","direction","etaProcessAt","requestedAt","stage","user"]},"PendingDegradation":{"type":"object","properties":{"affectedProjection":{"type":"string","minLength":1,"example":"pending_requests"},"eventName":{"type":"string","minLength":1,"example":"WithdrawalRequested"},"missingEventFields":{"type":"array","items":{"type":"string"},"example":["withdrawal_fee"]},"reason":{"type":"string","enum":["legacy_event_layout","missing_baseline_position","census_reconciled","evm_unsupported_fee_ledger"],"example":"legacy_event_layout"}},"required":["affectedProjection","eventName","missingEventFields","reason"],"description":"Stored projection-quality detail when available; older incomplete rows may carry only degraded: true."},"PendingResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/PendingData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"PendingData":{"type":"object","properties":{"deposits":{"type":"array","items":{"$ref":"#/components/schemas/PendingRequest"}},"user":{"type":"string","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"withdrawals":{"type":"array","items":{"$ref":"#/components/schemas/PendingRequest"}}},"required":["deposits","user","vaultId","withdrawals"]},"PendingRequest":{"type":"object","properties":{"amounts":{"$ref":"#/components/schemas/PendingAmounts"},"claimableAssets":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"1000000000000000000"},"cooldownEnd":{"type":["integer","null"],"minimum":0,"description":"Withdrawal eligibility timestamp in Unix seconds; null for deposits or incomplete historical requests.","example":1800086400},"degraded":{"type":"boolean","enum":[true],"description":"True when the historical event omitted fields required for a complete request projection.","example":true},"etaProcessAt":{"type":["integer","null"],"minimum":0,"description":"Estimated processing timestamp in Unix seconds, derived from withdrawal redemption cycles or keeper cadence. It is operational guidance, not a settlement promise, and is null for terminal or insufficiently configured requests.","example":1800090000},"etaReason":{"type":"string","enum":["evm_manager_settles"],"example":"evm_manager_settles"},"origin":{"type":"string","enum":["request","switch","mixed"],"description":"How funds entered this pending row. `switch` identifies target-bundle credit without a DepositRequested event.","example":"request"},"originBundle":{"type":"string","description":"Source bundle address when one switch source can be identified.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"requestedAt":{"type":"integer","minimum":0,"example":1800000000},"requestId":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","description":"EVM on-chain request ID when the controller pool contains one distinct ID; null for multiple IDs. IDs can be reused.","example":"0"},"requestIds":{"type":"array","items":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Lossless raw on-chain integer encoded as a decimal string.","example":"0"},"example":["0"],"description":"Distinct EVM request IDs contributing to this controller pool. Payout amounts are pooled, not attributed to individual IDs."},"signatures":{"type":"array","items":{"type":"string","minLength":1},"example":["5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"]},"stage":{"type":"string","enum":["requested","netted","processed","refunded"],"example":"requested"},"terminal":{"$ref":"#/components/schemas/PendingTerminal"}},"required":["amounts","cooldownEnd","etaProcessAt","origin","requestedAt","signatures","stage","terminal"]},"PendingTerminal":{"type":["object","null"],"properties":{"at":{"type":"integer","minimum":0,"example":1800003600},"signature":{"type":"string","minLength":1,"example":"5VERv8NM9zqPjqxJME5a3uW6S9JnvG96N2iJz6eR4VqWnTQk3sYp8cL1hF7dB2mK5xA9uC4rE6tG3jH8wP1oZ7s"}},"required":["at","signature"]},"UserPendingResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/UserPendingData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"UserPendingData":{"type":"object","properties":{"bundles":{"type":"array","items":{"$ref":"#/components/schemas/PendingBundle"}},"user":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["bundles","user"]},"PendingBundle":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"deposits":{"type":"array","items":{"$ref":"#/components/schemas/PendingRequest"}},"withdrawals":{"type":"array","items":{"$ref":"#/components/schemas/PendingRequest"}}},"required":["asOf","bundleKey","deposits","withdrawals"]},"InterestEarnedResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/InterestEarnedData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"InterestEarnedData":{"type":"object","properties":{"buckets":{"type":"array","items":{"$ref":"#/components/schemas/InterestEarnedBucket"}},"excludedBundleKeys":{"type":"array","items":{"type":"string"},"description":"Sorted bundle keys omitted because they have user history but no bundle_registry entry. These are retired legacy Drift vaults outside the ntbundle partner API scope.","example":["9vmBYT7hcjexuHM3iML3buTz3PchvULH5EfAjG12TtRZ"]},"granularity":{"type":"string","enum":["total","daily","monthly"],"example":"monthly"},"method":{"type":"string","enum":["value-delta-minus-net-flows"],"description":"For each bucket, earnings equal position-value delta minus signed net flows. Gross and net use the corresponding user_daily cumulative closes; today uses current projected state.","example":"value-delta-minus-net-flows"},"range":{"type":"object","properties":{"endDate":{"type":"string","format":"date","example":"2026-07-31"},"startDate":{"type":["string","null"],"format":"date","example":"2026-01-01"}},"required":["endDate","startDate"]},"scope":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["user"],"example":"user"}},"required":["type"]},{"type":"object","properties":{"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"type":{"type":"string","enum":["vault"],"example":"vault"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["bundleKey","type","vaultId"]}]},"user":{"type":"string","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["buckets","excludedBundleKeys","granularity","method","range","scope","user"]},"InterestEarnedBucket":{"type":"object","properties":{"earningsUsd":{"type":"object","properties":{"feesCharged":{"type":["number","null"],"example":0.25},"gross":{"type":["number","null"],"example":12.75},"net":{"type":["number","null"],"example":12.5}},"required":["feesCharged","gross","net"]},"endDate":{"type":"string","format":"date","example":"2026-07-31"},"period":{"type":"string","description":"YYYY-MM-DD for daily, YYYY-MM for monthly, or total","example":"2026-07"},"startDate":{"type":"string","format":"date","example":"2026-07-01"},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/VaultInterestEarnedBucket"}}},"required":["earningsUsd","endDate","period","startDate","vaults"]},"VaultInterestEarnedBucket":{"type":"object","properties":{"asset":{"type":"object","properties":{"decimals":{"type":["integer","null"],"minimum":0,"maximum":18,"example":6},"mint":{"type":["string","null"],"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}},"required":["decimals","mint"]},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"degraded":{"type":"boolean","enum":[true],"description":"True when any contributing user_daily close or live projection is degraded. Legacy-census closes are boundary-reconstructed values and are never presented as exact.","example":true},"earnings":{"$ref":"#/components/schemas/InterestEarnedAmounts"},"origin":{"type":"string","enum":["legacy-census","rollup","live","mixed"],"description":"Legacy buckets retain their transform provenance. Mixed means an aggregate spans origins.","example":"rollup"},"priceAsOf":{"type":["integer","null"],"minimum":0,"description":"Reference-price time used in this vault bucket, in Unix seconds. Current mainnet valuations use the CoinGecko reference-price tick time (hourly series, 3-hour freshness window); historical rows retain their stored source time, and fixed-price devnet valuations use projection time.","example":1800000000},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["asset","bundleKey","earnings","origin","priceAsOf","vaultId"]},"InterestEarnedAmounts":{"type":"object","properties":{"feesCharged":{"$ref":"#/components/schemas/InterestEarnedAmount"},"gross":{"$ref":"#/components/schemas/InterestEarnedAmount"},"net":{"allOf":[{"$ref":"#/components/schemas/InterestEarnedAmount"},{"description":"Gross earnings after the pending fee estimate at the bucket close"}]}},"required":["feesCharged","gross","net"]},"InterestEarnedAmount":{"type":"object","properties":{"token":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","description":"Exact signed amount in the token minor unit","example":"1250000"},"usd":{"type":["number","null"],"description":"USD value at the bucket prices, or null if any required price is missing","example":1.25}},"required":["token","usd"],"description":"Fees charged during this bucket, surfaced separately from earnings"},"PositionHistoryResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/PositionHistoryData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"PositionHistoryData":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"example":1},"excludedBundleKeys":{"type":"array","items":{"type":"string"},"description":"Sorted bundle keys omitted because their history has no bundle_registry entry. These are retired legacy Drift vaults outside the ntbundle partner API scope.","example":["9vmBYT7hcjexuHM3iML3buTz3PchvULH5EfAjG12TtRZ"]},"granularity":{"type":"string","enum":["total","daily","monthly"],"example":"daily"},"history":{"type":"array","items":{"$ref":"#/components/schemas/PositionHistoryPoint"}},"nextCursor":{"type":["string","null"],"description":"Opaque cursor for the next chronological page, or null on the final page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMiIsInZlcnNpb24iOjF9"},"range":{"type":"object","properties":{"endDate":{"type":"string","format":"date","example":"2026-07-31"},"startDate":{"type":["string","null"],"format":"date","example":"2026-01-01"}},"required":["endDate","startDate"]},"scope":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["user"],"example":"user"}},"required":["type"]},{"type":"object","properties":{"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"type":{"type":"string","enum":["vault"],"example":"vault"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["bundleKey","type","vaultId"]}]},"user":{"type":"string","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["count","excludedBundleKeys","granularity","history","nextCursor","range","scope","user"]},"PositionHistoryPoint":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC date of the selected close (or the live today tick).","example":"2026-07-22"},"degraded":{"type":"boolean","enum":[true],"description":"True when any vault point in this cross-vault close is degraded.","example":true},"feesPaidCumulativeUsd":{"type":["number","null"],"minimum":0,"example":0.25},"interestEarnedUsd":{"type":"object","properties":{"gross":{"type":["number","null"],"example":12.75},"net":{"type":["number","null"],"example":12.5}},"required":["gross","net"],"description":"Cross-vault sums of inception-to-date cumulative earnings at this close. Do not sum them across history points."},"origin":{"type":"string","enum":["legacy-census","rollup","live","mixed"],"description":"Mixed means the cross-vault close contains more than one source provenance.","example":"rollup"},"period":{"type":"string","description":"YYYY-MM-DD for daily, YYYY-MM for monthly, or total.","example":"2026-07-22"},"priceAsOf":{"type":["integer","null"],"minimum":0,"description":"Newest reference-price time in a complete cross-vault USD close, or null when its USD legs are null. Current mainnet valuations use CoinGecko reference-price ticks from the hourly series inside the 3-hour freshness window.","example":1800000000},"valueUsd":{"type":["number","null"],"minimum":0,"example":1025.5},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/VaultPositionHistoryPoint"}}},"required":["date","feesPaidCumulativeUsd","interestEarnedUsd","origin","period","priceAsOf","valueUsd","vaults"]},"VaultPositionHistoryPoint":{"type":"object","properties":{"asset":{"type":"object","properties":{"decimals":{"type":["integer","null"],"minimum":0,"maximum":18,"example":6},"mint":{"type":["string","null"],"example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}},"required":["decimals","mint"]},"bundleKey":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"chain":{"$ref":"#/components/schemas/ChainId"},"degraded":{"type":"boolean","enum":[true],"description":"True for a degraded source projection. All legacy-census snapshots are degraded boundary reconstructions because their complete high-water-mark state is unavailable.","example":true},"feesPaidCumulative":{"allOf":[{"$ref":"#/components/schemas/UnsignedPositionHistoryAmount"},{"type":"object","properties":{"token":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","description":"Exact amount in the token minor unit","example":"1250000"}}}],"description":"Cumulative fees paid through this close, not a per-period delta. EVM returns token and usd null because the per-user fee ledger is unsupported."},"interestEarned":{"type":"object","properties":{"gross":{"$ref":"#/components/schemas/PositionHistoryAmount"},"net":{"$ref":"#/components/schemas/PositionHistoryAmount"}},"required":["gross","net"],"description":"Inception-to-date cumulative earnings at this close. These are snapshots, not period deltas: do not sum them across history points. Use /interest-earned for period deltas."},"origin":{"type":"string","enum":["legacy-census","rollup","live"],"example":"rollup"},"pps":{"type":["string","null"],"pattern":"^(?:0|[1-9]\\d*)$","description":"Exact price per share in the asset minor-unit precision, or null for degraded zero-share legacy rows whose source snapshot had no PPS.","example":"1012500"},"priceAsOf":{"type":["integer","null"],"minimum":0,"description":"Reference-price time used by all USD legs in this vault point, or null when every USD leg is null. Current mainnet valuations use the CoinGecko reference-price tick time (hourly series, 3-hour freshness window); historical rows retain their stored source time, and fixed-price devnet valuations use projection time.","example":1800000000},"shares":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Exact amount in the token minor unit","example":"1250000"},"value":{"$ref":"#/components/schemas/UnsignedPositionHistoryAmount"},"vaultId":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"}},"required":["asset","bundleKey","feesPaidCumulative","interestEarned","origin","pps","priceAsOf","shares","value","vaultId"]},"UnsignedPositionHistoryAmount":{"type":"object","properties":{"token":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Exact amount in the token minor unit","example":"1250000"},"usd":{"type":["number","null"],"minimum":0,"description":"USD value at priceAsOf, or null together with every other USD leg when the price group is unavailable","example":101.25}},"required":["token","usd"]},"PositionHistoryAmount":{"type":"object","properties":{"token":{"type":"string","pattern":"^(?:0|-?[1-9]\\d*)$","description":"Exact signed amount in the token minor unit","example":"1250000"},"usd":{"type":["number","null"],"description":"USD value at priceAsOf, or null together with every other USD leg when the price group is unavailable","example":1.25}},"required":["token","usd"]},"VaultBalanceResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/VaultBalanceData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"VaultBalanceData":{"allOf":[{"$ref":"#/components/schemas/VaultBalanceRow"},{"type":"object","properties":{"scope":{"type":"string","enum":["ntbundle-program-vaults"],"description":"All Solana ntbundle-program vaults and EVM vaults present in bundle_registry are included; the scope string retains its compatibility spelling. catalog_visible is a payload hint and does not control authenticated API inclusion; retired legacy Drift-program vaults are excluded.","example":"ntbundle-program-vaults"},"user":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"}},"required":["scope","user"]}]},"UnpaidFeeEstimate":{"type":["object","null"],"properties":{"estimatedAt":{"type":"integer","minimum":0,"example":1800000030},"managementFeeShares":{"$ref":"#/components/schemas/TokenAmount"},"performanceFeeShares":{"$ref":"#/components/schemas/TokenAmount"},"totalFeeShares":{"$ref":"#/components/schemas/TokenAmount"},"value":{"$ref":"#/components/schemas/TokenValue"}},"required":["estimatedAt","managementFeeShares","performanceFeeShares","totalFeeShares","value"],"description":"Estimate using projected per-user fee overrides. Overrides set before the projection boundary appear after the next continuity census seed."},"VaultBalanceRow":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"asset":{"$ref":"#/components/schemas/BalanceAsset"},"effectiveFees":{"$ref":"#/components/schemas/EffectiveFees"},"feeOverrides":{"$ref":"#/components/schemas/FeeOverrides"},"feesPaid":{"allOf":[{"$ref":"#/components/schemas/TokenAmount"},{"type":["object","null"]}]},"firstDepositAt":{"type":"integer","minimum":0,"example":1700000000},"hwmPerShare":{"allOf":[{"$ref":"#/components/schemas/TokenAmount"},{"type":["object","null"]}]},"lastFeeChargedAt":{"type":["integer","null"],"minimum":0,"description":"Unix timestamp of the latest projected fee charge, or null when absent.","example":1799000000},"netDeposits":{"$ref":"#/components/schemas/SignedTokenAmount"},"pps":{"$ref":"#/components/schemas/TokenAmount"},"shares":{"$ref":"#/components/schemas/TokenAmount"},"unpaidFeeEstimate":{"$ref":"#/components/schemas/UnpaidFeeEstimate"},"value":{"$ref":"#/components/schemas/TokenValue"},"vault":{"$ref":"#/components/schemas/BalanceVault"}},"required":["asOf","asset","effectiveFees","feeOverrides","feesPaid","firstDepositAt","hwmPerShare","lastFeeChargedAt","netDeposits","pps","shares","unpaidFeeEstimate","value","vault"]},"PortfolioResponse":{"type":"object","properties":{"asOf":{"$ref":"#/components/schemas/AsOf"},"data":{"$ref":"#/components/schemas/PortfolioData"},"priceAsOf":{"$ref":"#/components/schemas/AsOf"},"success":{"type":"boolean","enum":[true],"example":true}},"required":["asOf","data","success"]},"PortfolioData":{"type":"object","properties":{"aggregate":{"$ref":"#/components/schemas/PortfolioAggregate"},"scope":{"type":"string","enum":["ntbundle-program-vaults"],"description":"All Solana ntbundle-program vaults and EVM vaults present in bundle_registry are included; the scope string retains its compatibility spelling. catalog_visible is a payload hint and does not control authenticated API inclusion; retired legacy Drift-program vaults are excluded.","example":"ntbundle-program-vaults"},"unavailableVaults":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]},"description":"Bundle addresses for held vaults omitted because their position or bundle-state projection is degraded. They are excluded from vault rows and all aggregates.","example":["2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"]},"user":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"vaults":{"type":"array","items":{"$ref":"#/components/schemas/VaultBalanceRow"}}},"required":["aggregate","scope","unavailableVaults","user","vaults"]},"PortfolioAggregate":{"type":"object","properties":{"assets":{"type":"array","items":{"$ref":"#/components/schemas/PortfolioAssetTotal"}},"missingPriceMints":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}]},"example":["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]},"valueUsd":{"type":"number","example":5432.1}},"required":["assets","missingPriceMints"]},"PortfolioAssetTotal":{"type":"object","properties":{"asset":{"$ref":"#/components/schemas/BalanceAsset"},"feesPaid":{"allOf":[{"$ref":"#/components/schemas/TokenAmount"},{"type":["object","null"]}]},"netDeposits":{"$ref":"#/components/schemas/SignedTokenAmount"},"unpaidFeeEstimate":{"$ref":"#/components/schemas/TokenValue"},"value":{"$ref":"#/components/schemas/TokenValue"}},"required":["asset","feesPaid","netDeposits","unpaidFeeEstimate","value"]}},"parameters":{}},"paths":{"/public/yields":{"get":{"description":"Unauthenticated aggregate of catalog-visible vaults for external yield aggregators such as DefiLlama. Serves projection-backed USD TVL and PPS APY windows before the API fee adjustment, expressed as decimal fractions (0.12 means 12%). Each row includes its chain; EVM programId is the strategy address and sampled PPS already reflects protocol fee dilution. Rows are limited to visible, enabled, non-deprecated, non-private vaults. Unavailable Solana vaults are isolated in unavailableVaults; registered EVM vaults require healthy projections, and visible EVM vaults require metrics. Current mainnet TVL is null without an eligible reference-price tick. Successful responses are cached for 60 seconds. asOf and dataAsOf identify the oldest observation among returned vaults, comparing different chains by block time; computedAt is their oldest metrics computation time. These three fields are null for an empty result. indexer_asOf separately reports the latest successfully projected Solana event time, or null before worker progress is recorded.","operationId":"getPublicYields","security":[],"summary":"Public vault yields for aggregators","tags":["Metrics"],"responses":{"200":{"description":"Catalog-visible vault TVL and gross APY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicYieldsResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required registry or projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/public/codes/{code}":{"get":{"description":"Public browser-time resolution of a human-readable partner code to the current Solana referrer address. Use this endpoint as the Neutral Trade SDK's ReferrerCodeResolver when building an attributed first-deposit transaction; partner API keys must never be shipped to the browser. Input is case-insensitive and the response returns the canonical uppercase code. Unknown, revoked, and disabled codes share one 404 response. Successful and not-found resolutions are memoized in-process and cacheable for 60 seconds. A code can be re-pointed to a new referrer, so clients must not cache a resolution beyond the response TTL.","operationId":"resolvePartnerCode","security":[],"summary":"Resolve a public builder code","tags":["Public"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$","description":"Case-insensitive builder code. It is folded to canonical uppercase before lookup.","example":"ACME"},"required":true,"description":"Case-insensitive builder code. It is folded to canonical uppercase before lookup.","in":"path","name":"code"}],"responses":{"200":{"description":"Canonical code and current referrer address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerCodeResolutionResponse"}}}},"400":{"description":"Malformed builder code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Code is unknown, revoked, or disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Public edge rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner code resolution is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/tx/deposit":{"post":{"description":"Returns an unsigned Solana v0 transaction with zero-filled signature slots; the server never holds keys and uses createNoopSigner for the wallet authority. The response provides transactionBase64 for wallet-adapter flows and instructions[] in the exact legacy /api/v1 wire shape for frontends composing their own message. Bundle-type vaults are the only supported layout. There is deliberately no cancel endpoint: ntbundle has no user-signed cancel or claim instruction. Withdrawal uses a keeper-push lifecycle: request, cooldown, then keeper process_withdrawal transfers assets to the user associated token account, so voltr-style cancel parity is impossible. Attribution soft-fails with machine-readable reasons so a willing depositor is never dead-ended. Failed attribution discloses an existing onchain referrer and whether it matches the requested referrer when both addresses are known. Set requireAttribution=true to reject any attribution failure with ATTRIBUTION_REQUIRED and no transaction. Attribution is feature-flagged off in production until the netting keeper handles referral remaining_accounts; that path returns ATTRIBUTION_NOT_YET_ENABLED.","operationId":"buildVaultDepositTransaction","security":[{},{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Build an unsigned vault deposit transaction","tags":["Transactions"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana bundle address stored in bundle_registry.bundle_key","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address stored in bundle_registry.bundle_key","in":"path","name":"id"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositTransactionRequest"}}}},"responses":{"200":{"description":"Deposit validation verdict and, when accepted, an unsigned transaction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositTransactionResponse"},"examples":{"accepted":{"summary":"Unsigned deposit transaction","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"blockhash":"11111111111111111111111111111111","computeUnitLimit":240000,"instructions":[],"lastValidBlockHeight":280000000,"priorityFeeMicroLamports":"25000","signers":["GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"],"simulation":"simulated","transactionBase64":"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAA==","validation":{"accepted":true,"rejectionReasons":[]}},"success":true}},"attributionSoftFail":{"summary":"Unattributed fallback transaction","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"blockhash":"11111111111111111111111111111111","computeUnitLimit":240000,"instructions":[],"lastValidBlockHeight":280000000,"priorityFeeMicroLamports":"25000","signers":["GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"],"simulation":"simulated","transactionBase64":"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAA==","validation":{"accepted":true,"rejectionReasons":[]},"attribution":{"applied":false,"existingReferrer":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp","existingReferrerMatchesRequest":true,"reason":"REFERRAL_ALREADY_SET"}},"success":true}},"attributionRequired":{"summary":"Strict attribution rejection","value":{"asOf":{"blockTime":1800000000,"slot":0},"data":{"attribution":{"applied":false,"reason":"ATTRIBUTION_NOT_YET_ENABLED"},"validation":{"accepted":false,"rejectionReasons":[{"code":"ATTRIBUTION_REQUIRED","message":"Attribution is required but could not be applied: ATTRIBUTION_NOT_YET_ENABLED"}]}},"success":true}},"rejected":{"summary":"Structured vault rejection","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"validation":{"accepted":false,"rejectionReasons":[{"code":"MIN_DEPOSIT_AMOUNT_NOT_MET","message":"Deposit amount is below the vault minimum"}]}},"success":true}}}}}},"400":{"description":"Malformed path parameters or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"401":{"description":"Invalid optional partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"422":{"description":"Well-formed transaction failed preflight","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationFailedResponse"}}}},"429":{"description":"Transaction build rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"503":{"description":"RPC or required live vault state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}}}}},"/v2/vault/{id}/tx/withdraw":{"post":{"description":"Returns an unsigned Solana v0 transaction with zero-filled signature slots; the server never holds keys and uses createNoopSigner for the wallet authority. The response provides transactionBase64 for wallet-adapter flows and instructions[] in the exact legacy /api/v1 wire shape for frontends composing their own message. Bundle-type vaults are the only supported layout. There is deliberately no cancel endpoint: ntbundle has no user-signed cancel or claim instruction. Withdrawal uses a keeper-push lifecycle: request, cooldown, then keeper process_withdrawal transfers assets to the user associated token account, so voltr-style cancel parity is impossible. The builder prepends an idempotent create for the user's asset associated token account so keeper settlement cannot fail when that account is missing. The user pays the same rent the account would need anyway. Attribution applies only to deposits.","operationId":"buildVaultWithdrawTransaction","security":[{},{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Build an unsigned vault withdrawal transaction","tags":["Transactions"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana bundle address stored in bundle_registry.bundle_key","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address stored in bundle_registry.bundle_key","in":"path","name":"id"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawTransactionRequest"}}}},"responses":{"200":{"description":"Withdrawal validation verdict and, when accepted, an unsigned transaction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawTransactionResponse"},"examples":{"accepted":{"summary":"Unsigned withdrawal transaction","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"blockhash":"11111111111111111111111111111111","computeUnitLimit":240000,"instructions":[],"lastValidBlockHeight":280000000,"priorityFeeMicroLamports":"25000","signers":["GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"],"simulation":"simulated","transactionBase64":"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAA==","validation":{"accepted":true,"rejectionReasons":[]},"sharesAmount":"50000000"},"success":true}},"rejected":{"summary":"Structured missing-position rejection","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"validation":{"accepted":false,"rejectionReasons":[{"code":"USER_BUNDLE_ACCOUNT_NOT_FOUND","message":"User has no position in this vault"}]}},"success":true}}}}}},"400":{"description":"Malformed path parameters or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"401":{"description":"Invalid optional partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"422":{"description":"Well-formed transaction failed preflight","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationFailedResponse"}}}},"429":{"description":"Transaction build rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}},"503":{"description":"RPC or required live vault state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TxErrorResponse"}}}}}}},"/v2/lender/challenge":{"post":{"operationId":"createLenderChallenge","summary":"Issue a three-hour lender consent challenge","tags":["Lender agreements"],"security":[],"description":"Sign the returned message exactly. The nonce is bound to the wallet, chain, vault, purpose, terms version and origin. The fixed VOA template has no nonce field; its exact message identifies the single-use challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"chainId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Must match the registered vault chain. Configure EVM_RPC_URL_<chainId> for every chain with a registered vault."},"vaultId":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"purpose":{"type":"string","enum":["tos","voa"]}},"required":["wallet","chainId","vaultId","purpose"],"additionalProperties":false}}}},"responses":{"200":{"description":"Exact message and single-use challenge","content":{"application/json":{"schema":{"type":"object","properties":{"nonce":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"issuedAt":{"type":"string","format":"date-time"},"message":{"type":"string","minLength":1,"maxLength":135168},"termsVersion":{"type":"string","minLength":1}},"required":["nonce","expiresAt","issuedAt","message","termsVersion"]}}}},"400":{"description":"Malformed, expired, mismatched, or invalid proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Origin is not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered EVM vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Replay, challenge conflict, or changed terms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Request body is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"IP or wallet quota exceeded; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Datastore or service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Verification is disabled, RPC failed, or terms are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/lender/agreements":{"post":{"operationId":"submitLenderAgreement","summary":"Verify and store lender consent","tags":["Lender agreements"],"security":[],"description":"Verifies the submitted UTF-8 message without reconstruction, using the registered vault chain. Supports EOA, EIP-1271 and delegated EOA signatures. Records the verification time and block.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"chainId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Must match the registered vault chain. Configure EVM_RPC_URL_<chainId> for every chain with a registered vault."},"vaultId":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"agreementType":{"type":"string","enum":["TOS","VOA"]},"message":{"type":"string","minLength":1,"maxLength":135168},"signature":{"type":"string","maxLength":65538,"pattern":"^0x(?:[0-9a-fA-F]{2})+$"}},"required":["wallet","chainId","vaultId","agreementType","message","signature"],"additionalProperties":false}}}},"responses":{"201":{"description":"Verified consent stored; nonce consumed atomically","content":{"application/json":{"schema":{"type":"object","properties":{"verified":{"type":"boolean","enum":[true]},"walletType":{"type":"string","enum":["eoa","contract"]},"termsVersion":{"type":"string","minLength":1}},"required":["verified","walletType","termsVersion"]}}}},"400":{"description":"Malformed, expired, mismatched, or invalid proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Origin is not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered EVM vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Replay, challenge conflict, or changed terms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Request body is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"IP or wallet quota exceeded; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Datastore or service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Verification is disabled, RPC failed, or terms are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/lender/{wallet}/vault/{vaultId}/eligibility":{"get":{"operationId":"getLenderEligibility","summary":"Read current lender consent eligibility","tags":["Lender agreements"],"security":[],"description":"Consent-only gate, read from MongoDB without RPC or caching. Does not promise that an on-chain deposit will succeed. A new VOA version requires a new signature; absent VOA terms require ToS only.","parameters":[{"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"required":true,"name":"wallet","in":"path"},{"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"required":true,"name":"vaultId","in":"path"}],"responses":{"200":{"description":"Current required versions and matching consent","content":{"application/json":{"schema":{"type":"object","properties":{"tos":{"type":"object","properties":{"signed":{"type":"boolean"},"version":{"type":"string","minLength":1}},"required":["signed","version"]},"voa":{"type":"object","properties":{"signed":{"type":"boolean"},"version":{"type":["string","null"],"minLength":1},"required":{"type":"boolean"}},"required":["signed","version","required"]},"canDeposit":{"type":"boolean"}},"required":["tos","voa","canDeposit"]}}}},"400":{"description":"Malformed, expired, mismatched, or invalid proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Origin is not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered EVM vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Replay, challenge conflict, or changed terms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Request body is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"IP or wallet quota exceeded; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Datastore or service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Verification is disabled, RPC failed, or terms are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/lender/vault/{vaultId}/terms":{"get":{"operationId":"getLenderTerms","summary":"Read operator-loaded VOA text","tags":["Lender agreements"],"security":[],"parameters":[{"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"required":true,"name":"vaultId","in":"path"}],"responses":{"200":{"description":"Verbatim signing text, display text and sha256 version; null text/version if not loaded","content":{"application/json":{"schema":{"type":"object","properties":{"vaultId":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"loanAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x24b84023c8e4Da635be228C380C09bfE5271BF9d"},"chainId":{"type":"integer"},"required":{"type":"boolean"},"version":{"type":["string","null"],"minLength":1},"loan_terms_text":{"type":["string","null"],"maxLength":131072},"clear_terms_text":{"type":["string","null"],"maxLength":131072}},"required":["vaultId","loanAddress","chainId","required","version","loan_terms_text","clear_terms_text"]}}}},"400":{"description":"Malformed, expired, mismatched, or invalid proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Origin is not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered EVM vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Replay, challenge conflict, or changed terms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Request body is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"IP or wallet quota exceeded; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Datastore or service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Verification is disabled, RPC failed, or terms are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/challenge":{"post":{"description":"Creates a five-minute SIWS input and canonical message. When the request carries an allowed browser Origin, the SIWS domain and URI bind to that origin; without an Origin header, the configured portal origin is used. Other origins are rejected. The request ID is authenticated by the server, and the nonce can be consumed only once.","operationId":"createPartnerSiwsChallenge","security":[],"summary":"Create a partner SIWS challenge","tags":["Partners"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerChallengeRequest"}}}},"responses":{"200":{"description":"SIWS input ready for wallet signing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerChallengeResponse"}}}},"400":{"description":"Invalid request fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The request origin may not request SIWS challenges","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Public partner endpoint rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner control-plane authentication is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/session":{"post":{"description":"Verifies an owner-wallet SIWS proof, creates an approved organization when the wallet is new, consumes the nonce, and returns a one-hour session.","operationId":"createPartnerSession","security":[],"summary":"Sign in to a partner organization","tags":["Partners"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerSessionRequest"}}}},"responses":{"200":{"description":"Organization session minted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerSessionResponse"}}}},"400":{"description":"Invalid request fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Invalid, expired, or replayed SIWS proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The verified wallet cannot perform this operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Organization creation state was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Wallet or generated organization identity conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Public partner endpoint rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner control-plane authentication is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/profile":{"get":{"operationId":"getPartnerProfile","security":[{"SiwsSessionAuth":[]}],"summary":"Read the current partner profile","tags":["Partners"],"responses":{"200":{"description":"The session organization profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerProfileResponse"}}}},"400":{"description":"Invalid request fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The session wallet does not own this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Organization state was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Unique value or concurrent state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner control plane is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/codes":{"get":{"operationId":"listPartnerCodes","security":[{"SiwsSessionAuth":[]}],"summary":"List partner builder codes","tags":["Partners"],"responses":{"200":{"description":"Builder codes owned by the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerCodeListResponse"}}}},"400":{"description":"Invalid request fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The session wallet does not own this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Organization state was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Unique value or concurrent state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner control plane is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Claims, enables, or disables a canonical builder code. The referrer is always the organization owner wallet and codes are globally unique.","operationId":"upsertPartnerCode","security":[{"SiwsSessionAuth":[]}],"summary":"Claim or manage a builder code","tags":["Partners"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertPartnerCodeRequest"}}}},"responses":{"200":{"description":"Builder code stored","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertPartnerCodeResponse"}}}},"400":{"description":"Invalid request fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The session wallet does not own this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Organization state was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Unique value or concurrent state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner control plane is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/wallet/rotate":{"post":{"description":"Requires both the current owner session and a rotate-owner SIWS proof from the incoming wallet. Login and organization data access move atomically. Historical accruals remain at the previous wallet address. The incoming owner completes a fresh session proof after rotation; no session for that wallet is disclosed to the outgoing owner.","operationId":"rotatePartnerOwner","security":[{"SiwsSessionAuth":[]}],"summary":"Rotate the partner owner wallet","tags":["Partners"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotatePartnerOwnerRequest"}}}},"responses":{"200":{"description":"Owner rotated; the incoming wallet can now create its own session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotatePartnerOwnerResponse"}}}},"400":{"description":"Invalid request fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The session wallet does not own this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Organization state was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Unique value or concurrent state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner control plane is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/keys":{"post":{"description":"Issues a production partner API key. Any valid partner key can read all authenticated referrer projections. The plaintext key appears only in this no-store response; only its SHA-256 hash is retained.","operationId":"issuePartnerKey","security":[{"SiwsSessionAuth":[]}],"summary":"Issue a partner API key","tags":["Partners"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuePartnerKeyRequest"}}}},"responses":{"201":{"description":"Key issued; save the plaintext now","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedPartnerKeyResponse"}}}},"400":{"description":"Invalid lifecycle request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session; partner API keys are not accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The SIWS wallet is not an owner of this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Partner or key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The key ID or lifecycle state changed concurrently","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner lifecycle service is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Lists lifecycle, quota, and usage metadata for the SIWS session organization. Plaintext keys and hashes are never returned, including for revoked audit rows.","operationId":"listPartnerKeys","security":[{"SiwsSessionAuth":[]}],"summary":"List partner API keys","tags":["Partners"],"responses":{"200":{"description":"Organization key metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerKeyListResponse"}}}},"400":{"description":"Invalid lifecycle request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session; partner API keys are not accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The SIWS wallet is not an owner of this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Partner or key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The key ID or lifecycle state changed concurrently","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner lifecycle service is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/keys/{keyId}/rotate":{"post":{"description":"Issues a replacement in a no-store response and schedules the predecessor to revoke after a 60-second grace window. The old key works through that window and returns 401 afterward. Rotation requires the owner SIWS session; a partner API key cannot rotate itself.","operationId":"rotatePartnerKey","security":[{"SiwsSessionAuth":[]}],"summary":"Rotate a partner API key","tags":["Partners"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"018f2c70-66b8-7ef4-a672-4f8657e5d12c"},"required":true,"name":"keyId","in":"path"}],"responses":{"201":{"description":"Replacement issued; save the plaintext now","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedPartnerKeyResponse"}}}},"400":{"description":"Invalid lifecycle request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session; partner API keys are not accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The SIWS wallet is not an owner of this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Partner or key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The key ID or lifecycle state changed concurrently","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner lifecycle service is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/keys/{keyId}/revoke":{"post":{"description":"Immediately marks the key revoked in the datastore and retains its audit row. API instances that already cached a successful authentication reject it within the documented 60-second partner-gate cache TTL.","operationId":"revokePartnerKey","security":[{"SiwsSessionAuth":[]}],"summary":"Revoke a partner API key","tags":["Partners"],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"018f2c70-66b8-7ef4-a672-4f8657e5d12c"},"required":true,"name":"keyId","in":"path"}],"responses":{"200":{"description":"Key revoked and audit metadata retained","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokedPartnerKeyResponse"}}}},"400":{"description":"Invalid lifecycle request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid SIWS session; partner API keys are not accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The SIWS wallet is not an owner of this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Partner or key not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The key ID or lifecycle state changed concurrently","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Partner lifecycle service is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/status":{"get":{"operationId":"getStatus","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read API projection status","tags":["Status"],"responses":{"200":{"description":"API status and newest folded Solana projection cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No projected Solana bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/stats":{"get":{"description":"Reads platform-wide stats for every registered Solana ntbundle and initialized EVM vault without RPC. EVM registry metadata contributes only after a current bundle projection exists; registry seeding alone does not require an EVM rollup cursor. catalog_visible does not control inclusion; retired legacy Drift-program vaults are excluded. TVL is the live bundle_state_current underlying_balance plus external_equity (plus accrued_penalties for EVM) at each vault cursor. Per-vault rows carry exact cursors; the envelope asOf is the oldest contributing bundle cursor. TVL assets are grouped by chain and asset symbol (falling back to mint) and valued with the shared price policy: fixed $1.0 for every devnet asset and the nearest CoinGecko reference-price tick in the hourly series inside the 3-hour freshness window for each mainnet asset. aggregate.tvl.valueUsd is omitted when any included mint is listed in missingPriceMints. userCount is the number of distinct user addresses with shares greater than zero in user_positions, deduplicated across vaults on each chain for the aggregate. EVM fee-ledger-only degradation does not exclude an authoritative share balance. Capital raised uses the latest per-user user_daily contributed_cum legacy opening through the migration cutoff, then adds bundle_daily flows.deposit_processed.gross after the cutoff through capitalRaised.throughDate. The basis field identifies this continuity-preserving method because migrated legacy bundle flow buckets are zero. EVM capital includes completed deposit gross from genesis, without the Solana cutoff; transfer flows and minted fee shares are excluded. switch_in is excluded because switched funds later produce deposit_processed on the target vault and counting both would duplicate capital. priceAsOf.blockTime is the oldest included effective valuation time and priceAsOf.slot is the aggregate projection slot. A missing or degraded contributing projection, or a missing daily-rollup watermark, returns 503.","operationId":"getPlatformStats","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read platform-wide projected stats","tags":["Stats"],"responses":{"200":{"description":"Platform TVL, active users, and capital raised","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection or rollup state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vaults":{"get":{"description":"Enumerates the canonical bundle_registry and joins each row to bundle_state_current without RPC. Registry membership defines scope, so retired legacy-only vaults are excluded while catalog-visible and catalog-enabled flags never control API inclusion. Only visible=true rows should be presented in a partner catalog; null means no reviewed catalog decision. A bundle with missing or degraded current state is isolated in unavailableVaults while healthy vault rows remain available; missing or degraded EVM state fails the response with 503; for Solana-only directories, the route returns 503 only when no registry bundle has any projection cursor. Visible rows carry name, category, asset.symbol, and minWithdrawAmount; Solana rows also carry legacyVaultId. Raw limit fields, including minWithdrawAmount, referral.minDepositAmount, and referral.tiers thresholds, preserve exact token minor-unit integers; maxCap aliases maxDepositAmount for Solana; EVM maxCap is LoanTermsSet capacity and EVM maxDepositAmount is the sampled deposit gate. EVM minWithdrawAmount is the raw share minimum, not an asset amount. EVM rows add chainId, asset.address, and the evm config block. referral includes the ordered active tier ladder for Solana; it is null for EVM or when legacy referral fields are absent. chain is registry identity metadata, and ntMultiplier is a static reviewed config value rather than a computed points figure. The envelope asOf is the oldest included healthy projection cursor, or the oldest observed degraded cursor when every row is unavailable. Mixed-chain freshness is compared by block time because block numbers belong to separate chains. EVM asOf includes chain and blockNumber equal to slot.","operationId":"getVaults","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List canonical vaults and current config","tags":["Vaults"],"responses":{"200":{"description":"Canonical vault directory and live config","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultDirectoryResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required registry or projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}":{"get":{"description":"Reads one canonical registry vault and its current lifecycle projection without RPC. The lifecycle fields retain exact projected timestamps; unavailable optional facts are null. EVM rows add chainId, asset.address and evm config. EVM has no process schedule or referral. EVM minWithdrawAmount is minRedeem in share minor units; minDepositAmount and maxCap are asset minor units. EVM maxCap comes from LoanTermsSet and maxDepositAmount is the sampled contract limit, null if unsampled. maxWithdraw is controller-specific and unsampled, so it is null. NAV staleness is evaluated at request time. minWithdrawAmount, referral.minDepositAmount, and referral.tiers thresholds are exact token minor-unit integers. referral includes the ordered active tier ladder for Solana; it is null for EVM or when legacy referral fields are absent. chain is registry identity metadata, and ntMultiplier is static reviewed configuration rather than a computed points figure. oracleAgeSeconds is the non-negative difference between request time and the projection block time, clamped at zero for clock skew.","operationId":"getVault","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read one vault config and lifecycle status","tags":["Vaults"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"}],"responses":{"200":{"description":"Vault config and projected lifecycle status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultDetailResponse"}}}},"400":{"description":"Invalid Solana bundle or EVM vault address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bundle address is not present in bundle_registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required bundle projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/metrics":{"get":{"description":"Reads computed 7-day, 30-day, 90-day, and inception APR/APY; non-annualized all-time and 30-day PPS ROI; 30-day Sharpe; maximum drawdown; fee schedule; and current TVL without RPC. Return and drawdown values use decimal fractions (0.12 means 12%); Sharpe is unitless. ROI is latest PPS / opening PPS - 1 and is never annualized. roiSince identifies the first-tick UTC date, and dateFromSnapshot is the ISO-8601 alias of computedAt. aprDayApplied replaces the ambiguous legacy scalar with exact elapsed-day coverage for each fixed APR window. Marketing targets and overrides are never substituted. Each after-fee rate applies the legacy partner presentation in decimal units: gross * (1 - performanceFeeBps / 10000) - managementFeeBps / 10000. Non-positive gross rates and positive rates whose result would be negative retain their gross value for legacy parity. Null rollup windows remain null after fees. The two roi*UsesLegacyPps flags identify returns that rely on migrated daily-mean PPS. The envelope asOf and tvl.asOf use the canonical bundle_state_current Solana cursor; bundle_metrics_current.asof_slot is never exposed because migrated legacy-daily rows can carry a synthetic day ordinal. For current mainnet USD, priceAsOf is the CoinGecko reference-price tick time (hourly series, 3-hour freshness window); fixed-price devnet values use projection time. yieldApr and drawdown dates remain outside this endpoint. An external vault (bundle_registry.kind external, ADR 0013) has a pps_series feed but no bundle_state_current: its cursor, PPS and TVL come from the newest tick (tvl.source pps_series, asOf.slot a synthetic day ordinal) and its fee schedule is zero (feeSchedule.source external_vault).","operationId":"getVaultMetrics","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read computed performance metrics for one vault","tags":["Metrics"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"}],"responses":{"200":{"description":"Projected vault performance metrics and TVL; data is null for a vault with no PPS tick yet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultMetricsResponse"}}}},"400":{"description":"Invalid bundle Solana address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The registered ntbundle vault does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/metrics/history":{"get":{"description":"Returns chronological UTC daily performance metrics from bundle_metrics_daily. startDate and endDate are inclusive; endDate defaults to today and an omitted startDate reads all available history. Each row is the replayable value produced from PPS data available through that completed day, so later ticks cannot rewrite an earlier date except when a late canonical tick correctly dirties and replays that date. origin is legacy-derived through the migrated daily seam and rollup afterward; post-seam fixed lookback windows can still include migrated daily-mean PPS ticks. APR, APY, and drawdown use decimal fractions and Sharpe is unitless. The 7-day, 30-day, 90-day, inception, Sharpe, and drawdown values are gross rollup metrics; current fee settings are not retroactively applied to historical points. The response is projection-only and never contacts Solana RPC.","operationId":"listVaultMetricsHistory","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read daily historical performance metrics for one vault","tags":["Metrics"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","format":"date","default":"2026-11-21","description":"Inclusive UTC end date. Defaults to the current UTC date.","example":"2026-07-31"},"required":false,"description":"Inclusive UTC end date. Defaults to the current UTC date.","name":"endDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date. Omit for all available daily metrics history.","example":"2026-07-01"},"required":false,"description":"Inclusive UTC start date. Omit for all available daily metrics history.","name":"startDate","in":"query"}],"responses":{"200":{"description":"Chronological daily performance metrics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultMetricsHistoryResponse"}}}},"400":{"description":"Invalid bundle address or date range","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The registered ntbundle vault does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Current bundle projection is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/simulate-deposit":{"get":{"description":"Previews a deposit from bundle_state_current, active pending-deposit projections, and vault fee/schedule configuration without Solana RPC. amount is raw asset minor units. Fee and share calculations use exact integer program semantics. Validation failures such as a minimum, maximum, cap, or paused-vault check are returned as a successful response with accepted=false and structured rejectionReasons. The endpoint has no user identity, so it cannot validate user state or apply per-user fee overrides. Deposits mint shares at netting, so a changed netting-time PPS can make the final shares differ from expectedShares.","operationId":"simulateVaultDeposit","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Simulate a vault deposit without RPC","tags":["Simulations"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Raw asset minor units as a canonical unsigned u64 decimal string. Zero returns a structured rejection verdict.","example":"100000000"},"required":true,"description":"Raw asset minor units as a canonical unsigned u64 decimal string. Zero returns a structured rejection verdict.","in":"query","name":"amount"}],"responses":{"200":{"description":"Projected deposit outcome and validation verdicts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositSimulationResponse"},"examples":{"accepted":{"summary":"Accepted by projected vault checks","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"asset":{"decimals":6,"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"calculatedAt":1800000000,"currentPps":{"raw":"1200000","token":"1.2"},"estimated":true,"totalAssets":{"raw":"1200000000","token":"1200"},"totalShares":{"raw":"1000000000","token":"1000"},"vault":{"bundleKey":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","id":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","programId":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"},"amount":{"raw":"100000000","token":"100"},"assumptions":{"feeSource":"vault","nettingPpsMayDrift":true,"userStateValidated":false},"direction":"deposit","expectedShares":{"raw":"83125000","token":"83.125"},"fee":{"amount":{"raw":"250000","token":"0.25"},"basisPoints":25},"limits":{"currentAssets":{"raw":"1200000000","token":"1200"},"maximumDepositAmount":{"raw":"2000000000","token":"2000"},"maximumVaultCap":{"raw":"2000000000","token":"2000"},"minimumDepositAmount":{"raw":"10000000","token":"10"},"pendingDeposits":{"raw":"50000000","token":"50"},"projectedAssets":{"raw":"1349750000","token":"1349.75"},"remainingCapacity":{"raw":"750000000","token":"750"}},"netAmount":{"raw":"99750000","token":"99.75"},"timing":{"cooldownEnd":null,"cooldownSeconds":0,"etaProcessAt":1800003600},"validation":{"accepted":true,"checks":{"amountPositive":true,"maximumDeposit":true,"minimumDeposit":true,"vaultCapacity":true,"vaultOpen":true},"rejectionReasons":[]}},"success":true}},"rejected":{"summary":"Structured minimum-deposit rejection","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"asset":{"decimals":6,"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"calculatedAt":1800000000,"currentPps":{"raw":"1200000","token":"1.2"},"estimated":true,"totalAssets":{"raw":"1200000000","token":"1200"},"totalShares":{"raw":"1000000000","token":"1000"},"vault":{"bundleKey":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","id":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","programId":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"},"amount":{"raw":"1000000","token":"1"},"assumptions":{"feeSource":"vault","nettingPpsMayDrift":true,"userStateValidated":false},"direction":"deposit","expectedShares":{"raw":"831250","token":"0.83125"},"fee":{"amount":{"raw":"2500","token":"0.0025"},"basisPoints":25},"limits":{"currentAssets":{"raw":"1200000000","token":"1200"},"maximumDepositAmount":{"raw":"2000000000","token":"2000"},"maximumVaultCap":{"raw":"2000000000","token":"2000"},"minimumDepositAmount":{"raw":"10000000","token":"10"},"pendingDeposits":{"raw":"50000000","token":"50"},"projectedAssets":{"raw":"1250997500","token":"1250.9975"},"remainingCapacity":{"raw":"750000000","token":"750"}},"netAmount":{"raw":"997500","token":"0.9975"},"timing":{"cooldownEnd":null,"cooldownSeconds":0,"etaProcessAt":1800003600},"validation":{"accepted":false,"checks":{"amountPositive":true,"maximumDeposit":true,"minimumDeposit":false,"vaultCapacity":true,"vaultOpen":true},"rejectionReasons":[{"code":"MIN_DEPOSIT_AMOUNT_NOT_MET","message":"Deposit amount is below the projected vault minimum"}]}},"success":true}}}}}},"400":{"description":"Invalid vault address or raw deposit amount","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/simulate-withdraw":{"get":{"description":"Previews a withdrawal from bundle_state_current and vault schedule configuration without Solana RPC. shares is the raw vault share amount. Gross assets use the SDK share-to-assets helper; the fee uses exact integer program semantics. Cooldown and etaProcessAt use the projected dynamic timing, redemption cycle, and keeper cadence. grossAmount and netAmount use the current projected PPS; the program recomputes the payout at settlement after cooldown, so PPS changes can alter the final assets. Business validation failures are returned as a successful response with accepted=false. The endpoint has no user identity, so it cannot validate the user share balance, pending-request conflicts, withdrawal delay, allowlist status, or per-user fee/timing overrides.","operationId":"simulateVaultWithdrawal","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Simulate a vault withdrawal without RPC","tags":["Simulations"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","pattern":"^(?:0|[1-9]\\d*)$","description":"Raw vault share minor units as a canonical unsigned u128 decimal string. Zero returns a structured rejection verdict.","example":"50000000"},"required":true,"description":"Raw vault share minor units as a canonical unsigned u128 decimal string. Zero returns a structured rejection verdict.","in":"query","name":"shares"}],"responses":{"200":{"description":"Projected withdrawal outcome and validation verdicts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawalSimulationResponse"},"examples":{"accepted":{"summary":"Accepted by projected vault checks","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"asset":{"decimals":6,"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"calculatedAt":1800000000,"currentPps":{"raw":"1200000","token":"1.2"},"estimated":true,"totalAssets":{"raw":"1200000000","token":"1200"},"totalShares":{"raw":"1000000000","token":"1000"},"vault":{"bundleKey":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","id":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","programId":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"},"assumptions":{"feeSource":"vault","nettingPpsMayDrift":true,"userStateValidated":false},"direction":"withdrawal","fee":{"amount":{"raw":"150000","token":"0.15"},"basisPoints":25},"grossAmount":{"raw":"60000000","token":"60"},"netAmount":{"raw":"59850000","token":"59.85"},"shares":{"raw":"50000000","token":"50"},"timing":{"cooldownEnd":1800003600,"cooldownSeconds":3600,"etaProcessAt":1800007200},"validation":{"accepted":true,"checks":{"estimatedAmountPositive":true,"sharesPositive":true,"sharesWithinVaultSupply":true,"vaultOpen":true},"rejectionReasons":[]}},"success":true}},"rejected":{"summary":"Structured paused-vault rejection","value":{"asOf":{"blockTime":1800000000,"slot":300000000},"data":{"asset":{"decimals":6,"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"calculatedAt":1800000000,"currentPps":{"raw":"1200000","token":"1.2"},"estimated":true,"totalAssets":{"raw":"1200000000","token":"1200"},"totalShares":{"raw":"1000000000","token":"1000"},"vault":{"bundleKey":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","id":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT","programId":"BUNDDh4P5XviMm1f3gCvnq2qKx6TGosAGnoUK12e7cXU"},"assumptions":{"feeSource":"vault","nettingPpsMayDrift":true,"userStateValidated":false},"direction":"withdrawal","fee":{"amount":{"raw":"150000","token":"0.15"},"basisPoints":25},"grossAmount":{"raw":"60000000","token":"60"},"netAmount":{"raw":"59850000","token":"59.85"},"shares":{"raw":"50000000","token":"50"},"timing":{"cooldownEnd":1800003600,"cooldownSeconds":3600,"etaProcessAt":1800007200},"validation":{"accepted":false,"checks":{"estimatedAmountPositive":true,"sharesPositive":true,"sharesWithinVaultSupply":true,"vaultOpen":false},"rejectionReasons":[{"code":"VAULT_PAUSED","message":"Vault deposits and withdrawals are paused"}]}},"success":true}}}}}},"400":{"description":"Invalid vault address or raw share amount","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/share-price":{"get":{"description":"Returns the current lossless PPS from bundle_state_current and, by default, a newest-first page from pps_series. Set includeSeries=false for the current value only. Indexed ticks have event resolution and include sourceEvent provenance. Migrated legacy ticks have daily resolution, carry isLegacy=true, and can use a synthetic slot solely as an ordering key. Date bounds are inclusive UTC dates and the opaque cursor is a strict newest-first keyset position.","operationId":"getVaultSharePrice","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read current and recent vault share prices","tags":["Vault history"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous share-price page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous share-price page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC end date for PPS ticks.","example":"2026-07-31"},"required":false,"description":"Inclusive UTC end date for PPS ticks.","name":"endDate","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"true","description":"Set false to return only the current PPS without reading pps_series.","example":"true"},"required":false,"description":"Set false to return only the current PPS without reading pps_series.","name":"includeSeries","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date for PPS ticks.","example":"2026-07-01"},"required":false,"description":"Inclusive UTC start date for PPS ticks.","name":"startDate","in":"query"}],"responses":{"200":{"description":"Current PPS and optional recent tick history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharePriceResponse"}}}},"400":{"description":"Invalid bundle, range, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Current bundle projection is unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/share-price-display":{"get":{"description":"Returns the daily share-price series the display metrics of GET /v2/vault/{id}/metrics are computed from: the migrated daily snapshot history on the continuous price basis, pre-launch days included (the phase of each point says backtest, pre-neutral or live), continued past its horizon with canonical ticks scaled onto that basis. It is deliberately not the canonical series; use /v2/vault/{id}/share-price for on-chain prices. One row per UTC day from the first close through at least the last complete UTC day, oldest first, optionally bounded by inclusive UTC dates: on-chain ticks are event-driven, so days without a close carry the previous one and are flagged carried. The current UTC day is included too whenever it already has a close of its own, and that close is still provisional until the day ends. The series is empty and liveFrom is null exactly when the display metrics are withheld: no live observations, an uncalibratable canonical tail, or a tail move over 50%.","operationId":"getVaultSharePriceDisplay","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read the display-basis daily share-price series","tags":["Vault history"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC end date.","example":"2026-07-31"},"required":false,"description":"Inclusive UTC end date.","name":"endDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date.","example":"2026-07-01"},"required":false,"description":"Inclusive UTC start date.","name":"startDate","in":"query"}],"responses":{"200":{"description":"Daily display-basis share prices","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharePriceDisplayResponse"}}}},"400":{"description":"Invalid bundle or range","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Current bundle projection is unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/snapshots":{"get":{"description":"Returns newest-first UTC daily closes from bundle_daily with lossless token values, flow and fee aggregates, and explicit historical provenance. Fee aggregates split charge-time user fees from collection-time manager withdrawals; mgmtValue and perfValue remain compatibility totals that combine both lifecycle stages, so period reporting should aggregate the charged or collected fields instead of those combined totals. The four split fields are omitted only for canonical rows awaiting the historical fee-split backfill; combined totals remain available during that transition. method distinguishes final-tick closes from legacy day means; isLegacy identifies migrated rows. Legacy history is daily resolution and can inherit the legacy USD $1.0 fallback documented in docs/api/history-resolution.md. closeTvlUsd, priceUsd, and priceAsOf are either all present or all absent. Date bounds are inclusive and pagination uses an opaque date keyset cursor.","operationId":"listVaultSnapshots","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List daily vault snapshots","tags":["Vault history"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous snapshot page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMSIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous snapshot page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC end date for daily closes.","example":"2026-07-31"},"required":false,"description":"Inclusive UTC end date for daily closes.","name":"endDate","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date for daily closes.","example":"2026-07-01"},"required":false,"description":"Inclusive UTC start date for daily closes.","name":"startDate","in":"query"}],"responses":{"200":{"description":"A descending page of daily vault closes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultSnapshotsResponse"}}}},"400":{"description":"Invalid bundle, range, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Registered ntbundle vault not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Current bundle projection is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/users":{"get":{"description":"Returns the vault holder cohort newest-first by firstDepositAt with an opaque wallet-tiebroken keyset cursor. Active positions (shares > 0) are returned by default; includeClosed=true includes exited-wallet history under the same ordering. Each row values shares at the current projected PPS, exposes signed net deposits, HWM and cumulative fee state, resolves the projected per-user effective fee schedule and overrides, identifies current referrer attribution, and marks active pending requests. includeAggregates=true adds page-invariant active-holder count and top-5/top-10 concentration; closed wallets never enter those aggregates. Every devnet asset uses a fixed $1.0 price; mainnet USD values are omitted when the hourly series has no CoinGecko reference-price tick inside the 3-hour freshness window. The whole route fails closed when its vault state or requested cohort projection is degraded and never contacts Solana RPC.","operationId":"listVaultUsers","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List holder wallets for one vault","tags":["Vaults"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":1024,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJ2IjoxLCJmaXJzdERlcG9zaXRBdCI6MTgwMDAwMDAwMCwid2FsbGV0IjoiR2dCYUNzM05wZUVKN1loVnRRekU5cnF3RzVhelNNUG1OSnlkSlZKczJlOTIifQ"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"string","default":false,"description":"Include page-invariant active-holder count and top-5/top-10 concentration.","example":false},"required":false,"description":"Include page-invariant active-holder count and top-5/top-10 concentration.","name":"includeAggregates","in":"query"},{"schema":{"type":"string","default":false,"description":"Include exited wallets whose current projected shares are zero.","example":false},"required":false,"description":"Include exited wallets whose current projected shares are zero.","name":"includeClosed","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"A newest-first page of vault holder wallets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultUsersResponse"}}}},"400":{"description":"Invalid vault address, flags, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The registered ntbundle vault does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required vault or cohort projection is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/user/{addr}/actions":{"get":{"description":"Returns indexed and migrated legacy user flows for the requested bundle key. If a retired legacy vault has no bundle_state_current row, its action rows are still returned: asOf falls back to the newest global projection cursor and asOfScope is global.","operationId":"listVaultUserActions","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List one user’s activity in a vault","tags":["User actions"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Solana or EVM user address"},"required":true,"description":"Solana or EVM user address","name":"addr","in":"path"},{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"$ref":"#/components/schemas/UserFlowType"},"required":false,"description":"User activity type. token_minted records a wallet's instant mint of a Solana bundle's receipt tokens: assets enter the bundle, whose share-token pool holds the shares, so the wallet's position does not change. transfer_in receives EVM vault shares and adds their value at the latest available transfer-time PPS to net deposits; it also records Solana receipt-token redemption importing pool shares into the user's position at the redemption-time value. transfer_out sends EVM vault shares and subtracts their transfer-time value. EVM wallet-to-wallet movements do not deposit or withdraw vault assets.","example":"deposit_processed","name":"flowType","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-01"},"required":false,"name":"startDate","in":"query"}],"responses":{"200":{"description":"A descending page of user activity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserActionsResponse"}}}},"400":{"description":"Invalid path, filter, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No global projected bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/users/{addr}/actions":{"get":{"description":"Returns indexed and migrated legacy user flows across bundle keys. The asOf cursor uses the newest global projection state and asOfScope is global.","operationId":"listUserActions","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List one user’s activity across vaults","tags":["User actions"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Solana or EVM user address"},"required":true,"description":"Solana or EVM user address","name":"addr","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"$ref":"#/components/schemas/UserFlowType"},"required":false,"description":"User activity type. token_minted records a wallet's instant mint of a Solana bundle's receipt tokens: assets enter the bundle, whose share-token pool holds the shares, so the wallet's position does not change. transfer_in receives EVM vault shares and adds their value at the latest available transfer-time PPS to net deposits; it also records Solana receipt-token redemption importing pool shares into the user's position at the redemption-time value. transfer_out sends EVM vault shares and subtracts their transfer-time value. EVM wallet-to-wallet movements do not deposit or withdraw vault assets.","example":"deposit_processed","name":"flowType","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-01"},"required":false,"name":"startDate","in":"query"}],"responses":{"200":{"description":"A descending page of user activity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserActionsResponse"}}}},"400":{"description":"Invalid path, filter, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No global projected bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/user/{addr}/fees":{"get":{"description":"Returns indexed management and performance charges plus migrated legacy fee charges for the requested bundle key. EVM vaults return 404 UNSUPPORTED_ON_CHAIN with chain because per-user fees are unsupported. Totals cover the full filtered window, not only the returned page. If a retired legacy vault has no bundle_state_current row, its fee rows are still returned: asOf falls back to the newest global projection cursor and asOfScope is global. Legacy rows from before the legacy-boundary migration carry no mgmt/perf split, no fee-share quantity, and no share price. Amounts are settlement-time token minor units. sharePrice on indexed rows is the exact onchain PPS at which the charge settled. Setting kind excludes the legacy source because those rows have no fee-kind split.","operationId":"listVaultUserFees","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List one user’s fee charges in a vault","tags":["User fees"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet on the vault chain"},"required":true,"description":"Wallet on the vault chain","name":"addr","in":"path"},{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsImluZGV4V2l0aGluQmxvY2siOjMsIml4SW5kZXgiOjEsImtpbmQiOiJwZXJmIiwib3JpZ2luIjoiaW5kZXhlZCIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInNsb3QiOjMwMDAwMDAwMCwidmF1bHRJZCI6IjJiUGlOZkdjN2V4VWNHa3ZWNW5ic1NrdU5IM2luRlUxOGtnTkVrQjhmaWFUIiwidmVyc2lvbiI6MX0"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string","enum":["mgmt","perf"],"description":"Restricts indexed charges to one fee kind. Legacy rows have no kind split and are excluded when this filter is set.","example":"perf"},"required":false,"description":"Restricts indexed charges to one fee kind. Legacy rows have no kind split and are excluded when this filter is set.","name":"kind","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-01"},"required":false,"name":"startDate","in":"query"}],"responses":{"200":{"description":"A descending page of user fee charges","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultUserFeesResponse"}}}},"400":{"description":"Invalid path, filter, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"EVM per-user fee ledger is unsupported: code UNSUPPORTED_ON_CHAIN and the registry chain; also returned for an unknown EVM vault","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsupportedChainResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No global projected bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/users/{addr}/fees":{"get":{"description":"Returns indexed management and performance charges plus migrated legacy fee charges across bundle keys. Totals cover the full filtered window and remain grouped by vault because token minor units cannot be summed across assets. Legacy rows from before the legacy-boundary migration carry no mgmt/perf split, no fee-share quantity, and no share price. Amounts are settlement-time token minor units. sharePrice on indexed rows is the exact onchain PPS at which the charge settled. Setting kind excludes the legacy source because those rows have no fee-kind split.","operationId":"listUserFees","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List one user’s fee charges across vaults","tags":["User fees"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Solana user address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"required":true,"description":"Solana user address","name":"addr","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJibG9ja1RpbWUiOjE4MDAwMDAwMDAsImV2ZW50SW5kZXgiOjIsImluZGV4V2l0aGluQmxvY2siOjMsIml4SW5kZXgiOjEsImtpbmQiOiJwZXJmIiwib3JpZ2luIjoiaW5kZXhlZCIsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsInNsb3QiOjMwMDAwMDAwMCwidmF1bHRJZCI6IjJiUGlOZkdjN2V4VWNHa3ZWNW5ic1NrdU5IM2luRlUxOGtnTkVrQjhmaWFUIiwidmVyc2lvbiI6MX0"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string","enum":["mgmt","perf"],"description":"Restricts indexed charges to one fee kind. Legacy rows have no kind split and are excluded when this filter is set.","example":"perf"},"required":false,"description":"Restricts indexed charges to one fee kind. Legacy rows have no kind split and are excluded when this filter is set.","name":"kind","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-01"},"required":false,"name":"startDate","in":"query"}],"responses":{"200":{"description":"A descending cross-vault page of user fee charges","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserFeesResponse"}}}},"400":{"description":"Invalid path, filter, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No global projected bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/referrer/{addr}/summary":{"get":{"operationId":"getReferrerSummary","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read builder-code earnings, tier progress, and attributed TVL","description":"Serves ntbundle-program projections only. referredNetDeposits is signed net deposited capital accumulated since referral-tier tracking was enabled, starts at 0 for pre-existing referrers without a backfill, can become negative, and deliberately differs from mark-to-market attributedTvl. Current and next tiers use the SDK’s onchain-equivalent schedule resolution. The summary is chain-verifiable: the reconciler compares it with ReferrerAccount, while this API performs no Solana RPC reads.","tags":["Referrer"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"required":true,"in":"path","name":"addr"}],"responses":{"200":{"description":"Current referrer accruals, tier progress, claimable value, and attributed TVL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerSummaryResponse"}}}},"400":{"description":"Invalid referrer address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No projected bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/referrer/{addr}/payouts":{"get":{"operationId":"listReferrerPayouts","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read builder-code payout history","description":"Returns the projection-only ReferrerWithdrawalProcessed ledger with opaque keyset pagination and explorer-linkable transaction signatures. totals is all-time and does not change across pages: count supports a claims badge, vaults preserves exact settled token amounts per asset, and redemptionUsd values those per-vault totals at current non-stale prices without adding unlike token minor units.","tags":["Referrer"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"required":true,"in":"path","name":"addr"},{"schema":{"type":"string","minLength":1,"maxLength":1024,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJ2IjoxLCJibG9ja1RpbWUiOjE4MDAwMDAwMDAsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsImV2ZW50SW5kZXgiOjJ9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Newest-first referrer payout ledger page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerPayoutResponse"}}}},"400":{"description":"Invalid address, cursor, or limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"No projected bundle state is available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/referrer/{addr}/history":{"get":{"operationId":"listReferrerHistory","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read daily builder-code economics and tier history","description":"Returns chronological UTC days from referrer_daily. Completed days are returned by default; includePartial=true opts into the newest provisional date with an explicit partial marker and partialThrough freshness time. Each date groups all attributed vaults without splitting a date across cursor pages. Each vault day carries the closing attributed-user count and the program-authored signed referred-net-deposit counter used for tier placement. Earnings are valued at the latest PPS for that date; totals expose both the daily earnings delta and a page-invariant inception-to-date cumulative earnings snapshot. Attributed TVL is the close value of the bind-time-stable cohort; deposits, withdrawals, and payouts are day aggregates. Exact token amounts remain decimal strings in minor and whole-token units. A vault day exposes every USD value and priceAsOf together, or nulls every USD value when its price is unavailable; cross-vault USD totals are likewise all-or-nothing. Date bounds are inclusive, and pagination uses an opaque chronological keyset cursor. Successful authenticated responses use a private one-day cache for completed-only reads or a private 60-second cache when partial coverage is requested, plus a strong ETag. The read path never contacts Solana RPC.","tags":["Referrer"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"required":true,"in":"path","name":"addr"},{"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Opaque cursor returned as nextCursor by the previous chronological page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMiIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous chronological page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date. Omit for all available history.","example":"2026-07-01"},"required":false,"description":"Inclusive UTC start date. Omit for all available history.","name":"from","in":"query"},{"schema":{"type":"string","default":false,"description":"Include the latest provisional UTC date when rollup coverage is available.","example":false},"required":false,"description":"Include the latest provisional UTC date when rollup coverage is available.","name":"includePartial","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC end date. Omitted or future dates are clamped to the completed watermark, or the provisional date when includePartial is true.","example":"2026-07-31"},"required":false,"description":"Inclusive UTC end date. Omitted or future dates are clamped to the completed watermark, or the provisional date when includePartial is true.","name":"to","in":"query"}],"responses":{"200":{"description":"A chronological page of daily referrer economics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerHistoryResponse"}}}},"304":{"description":"The current representation matches If-None-Match"},"400":{"description":"Invalid address, range, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection or rollup state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/referrer/{addr}/users":{"get":{"operationId":"listReferrerUsers","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List users attributed to a builder code","description":"Returns current user_positions attributed to the referrer, including exact shares, signed net deposits, first-deposit time, and historical performance- and management-fee snapshots from when that user bound the referrer. Those snapshots are not current rates: live settlement rates resolve from the referrer override flags, bundle tier schedule, and current referred net deposits.","tags":["Referrer"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"required":true,"in":"path","name":"addr"},{"schema":{"type":"string","minLength":1,"maxLength":1024,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJ2IjoxLCJidW5kbGVLZXkiOiIyYlBpTmZHYzdleFVjR2t2VjVuYnNTa3VOSDNpbkZVMThrZ05Fa0I4ZmlhVCIsInVzZXIiOiJHZ0JhQ3MzTnBlRUo3WWhWdFF6RTlycXdHNWF6U01QbU5KeWRKVkpzMmU5MiJ9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Vault-and-user-ordered attributed cohort page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerUsersResponse"}}}},"400":{"description":"Invalid address, cursor, or limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Attributed cohort projection is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/referrer/{addr}/flows":{"get":{"operationId":"listReferrerFlows","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List flows from attributed users","description":"Joins the referrer's projected user_positions cohort to user_flows. Results use the same flowType values as user action routes, accept inclusive UTC date filters, and use opaque newest-first keyset pagination.","tags":["Referrer"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"2VYioVd8gaE1Zp1sMbo1u48pSLSnBsX6da4xxQs1MAMp"},"required":true,"in":"path","name":"addr"},{"schema":{"type":"string","minLength":1,"maxLength":1024,"description":"Opaque cursor returned as nextCursor by the previous page.","example":"eyJ2IjoxLCJibG9ja1RpbWUiOjE4MDAwMDAwMDAsInNpZ25hdHVyZSI6IjVWRVJ2OE5NOXpxUGpxeEpNRTVhM3VXNlM5Sm52Rzk2TjJpSno2ZVI0VnFXblRRazNzWXA4Y0wxaEY3ZEIybUs1eEE5dUM0ckU2dEczakg4d1Axb1o3cyIsImV2ZW50SW5kZXgiOjIsInVzZXIiOiJHZ0JhQ3MzTnBlRUo3WWhWdFF6RTlycXdHNWF6U01QbU5KeWRKVkpzMmU5MiIsImZsb3dUeXBlIjoiZGVwb3NpdF9wcm9jZXNzZWQifQ"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"$ref":"#/components/schemas/UserFlowType"},"required":false,"description":"User activity type. token_minted records a wallet's instant mint of a Solana bundle's receipt tokens: assets enter the bundle, whose share-token pool holds the shares, so the wallet's position does not change. transfer_in receives EVM vault shares and adds their value at the latest available transfer-time PPS to net deposits; it also records Solana receipt-token redemption importing pool shares into the user's position at the redemption-time value. transfer_out sends EVM vault shares and subtracts their transfer-time value. EVM wallet-to-wallet movements do not deposit or withdraw vault assets.","example":"deposit_processed","name":"flowType","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-07-01"},"required":false,"name":"startDate","in":"query"}],"responses":{"200":{"description":"Newest-first attributed user-flow page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerFlowsResponse"}}}},"400":{"description":"Invalid address, date window, flow type, cursor, or limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Attributed cohort projection is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/partner/agreements":{"get":{"description":"Returns current onchain referral terms for every owner-wallet referrer and projected bundle. Effective rates match live fee settlement: each override flag selects its custom fee rate, while each unflagged side comes from the bundle tier reached by the referrer’s current signed net deposits. A full override bypasses the tier schedule; below the first threshold, including negative aggregates, unflagged rates are zero. The default fields are deprecated flat compatibility projections and are not used to resolve effective rates.","operationId":"listPartnerAgreements","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read current onchain referral terms","tags":["Partners"],"responses":{"200":{"description":"Current projected onchain referral terms","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerAgreementsResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Control-plane or projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/pending":{"get":{"description":"EVM rows represent controller pools: requestId is the sole contributing on-chain ID or null for multiple IDs (see requestIds). claimableAssets is the pool balance, with no fabricated per-request payout allocation. EVM cooldownEnd and etaProcessAt are null with etaReason=evm_manager_settles. An older EVM pool without request IDs or damaged projection returns 503. Returns a newest-first keyset page of open deposit and withdrawal requests for one vault. Direction and stage filters apply to both the page and aggregate; cursor and limit apply only to the page, so the direction × stage counts and lossless amount sums remain page-invariant. Solana ETA derivation reuses the user pending read model: redemption-cycle unlocks take precedence for withdrawals, followed by eligible netting, configured keeper cadence, and safe stored fallbacks. Requests with incomplete vintage timing fields have null ETAs, and every non-null ETA is an estimate, not a settlement promise. The read path uses pending_requests and bundle projections only and never contacts Solana RPC.","operationId":"listVaultPendingRequests","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"List a vault’s open request backlog","tags":["Vaults"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor returned as nextCursor by the previous newest-first page.","example":"eyJkaXJlY3Rpb24iOiJkZXBvc2l0IiwiZmlyc3RSZXF1ZXN0U2lnbmF0dXJlIjoiNVZFUnY4Tk05enFQanF4Sk1FNWEzdVc2UzlKbnZHOTZOMmlKejZlUjRWcVduVFFrM3NZcDhjTDFoRjdkQjJtSzV4QTl1QzRyRTZ0RzNqSDh3UDFvWjdzIiwicmVxdWVzdGVkQXQiOjE4MDAwMDAwMDAsInVzZXIiOiJHZ0JhQ3MzTnBlRUo3WWhWdFF6RTlycXdHNWF6U01QbU5KeWRKVkpzMmU5MiIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous newest-first page.","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["deposit","withdrawal"],"example":"deposit"},"required":false,"name":"direction","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["requested","netted"],"example":"requested"},"required":false,"name":"stage","in":"query"}],"responses":{"200":{"description":"A page and full-queue aggregate of open requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultPendingResponse"}}}},"400":{"description":"Invalid vault, filter, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Vault projection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/user/{addr}/pending":{"get":{"description":"EVM rows represent controller pools: requestId is the sole contributing on-chain ID or null for multiple IDs (see requestIds). claimableAssets is the pool balance, with no fabricated per-request payout allocation. EVM cooldownEnd and etaProcessAt are null with etaReason=evm_manager_settles. An older EVM pool without request IDs or damaged projection returns 503. Returns active requests plus recent terminal history for both directions. Solana ETA precedence for an active request with complete timing is: (1) a withdrawal requested by the projected redemption cutoff uses the current-cycle unlock when that unlock is at or after `max(requestedAt, cooldownEnd)`; otherwise it uses the next-cycle unlock when eligible; (2) a netted request already eligible at the latest netting uses `last_netting_at`; (3) the first configured UTC keeper cycle strictly after both `last_netting_at` and eligibility is used; (4) a stored request or bundle-state ETA at or after eligibility is used; otherwise the ETA is null. `30min`, `hourly`, and `daily` keeper schedules use their configured UTC process-time offsets; without an offset, cadence is anchored to `last_netting_at`. Terminal requests and requests missing required timing inputs have null ETAs; a row with degraded vintage amounts can still carry an ETA when its withdrawal timing is complete. Every ETA is an estimate, not a promise.","operationId":"getVaultUserPendingRequests","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read a user’s pending vault requests","tags":["Users"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM."},"required":true,"description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM.","name":"addr","in":"path"},{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","default":"7d","description":"Terminal-history lookback. Defaults to 7d; false or 0 excludes processed/refunded rows; maximum 90d.","example":"7d"},"required":false,"description":"Terminal-history lookback. Defaults to 7d; false or 0 excludes processed/refunded rows; maximum 90d.","name":"includeTerminal","in":"query"}],"responses":{"200":{"description":"Deposit and withdrawal lifecycle state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingResponse"}}}},"400":{"description":"Invalid vault, user, or terminal window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Vault projection not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/users/{addr}/pending":{"get":{"description":"EVM rows represent controller pools: requestId is the sole contributing on-chain ID or null for multiple IDs (see requestIds). claimableAssets is the pool balance, with no fabricated per-request payout allocation. EVM cooldownEnd and etaProcessAt are null with etaReason=evm_manager_settles. An older EVM pool without request IDs or damaged projection returns 503. Returns active requests plus recent terminal history across every bundle for one user. Results are grouped by bundle and reuse the per-vault pending-request shape, including switch attribution and schedule-derived ETA guidance. Each bundle carries its exact projection cursor; the envelope asOf is the oldest included cursor (the aggregate freshness floor).","operationId":"getUserPendingRequests","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read a user’s pending requests across bundles","tags":["Users"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM."},"required":true,"description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM.","name":"addr","in":"path"},{"schema":{"type":"string","default":"7d","description":"Terminal-history lookback. Defaults to 7d; false or 0 excludes processed/refunded rows; maximum 90d.","example":"7d"},"required":false,"description":"Terminal-history lookback. Defaults to 7d; false or 0 excludes processed/refunded rows; maximum 90d.","name":"includeTerminal","in":"query"}],"responses":{"200":{"description":"Cross-vault deposit and withdrawal lifecycle state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPendingResponse"}}}},"400":{"description":"Invalid user or terminal window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/user/{addr}/interest-earned":{"get":{"description":"Reads user_daily closes and appends today from user_positions and bundle_state_current. For every bucket, earnings equal position-value delta minus signed net flows. A vault bucket carries `degraded: true` when any contributing close or live projection is degraded; legacy-census closes are boundary-reconstructed derived values, not fabricated exact values. The read path never scans user_flows or contacts Solana RPC. The partner surface is ntbundle-scoped: history for retired legacy Drift vaults without a bundle_registry entry is omitted and reported in excludedBundleKeys.","operationId":"getVaultUserInterestEarned","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read one user’s interest earned for a vault","tags":["Users"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana wallet address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"required":true,"description":"Base58 Solana wallet address","in":"path","name":"addr"},{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","format":"date","default":"2026-11-21","description":"Inclusive UTC end date. Defaults to the current UTC date.","example":"2026-07-22"},"required":false,"description":"Inclusive UTC end date. Defaults to the current UTC date.","name":"endDate","in":"query"},{"schema":{"type":"string","enum":["total","daily","monthly"],"default":"total","description":"Bucket size. Total returns one bucket for the selected inclusive UTC range.","example":"monthly"},"required":false,"description":"Bucket size. Total returns one bucket for the selected inclusive UTC range.","name":"granularity","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date. Omit for the full available history.","example":"2026-01-01"},"required":false,"description":"Inclusive UTC start date. Omit for the full available history.","name":"startDate","in":"query"}],"responses":{"200":{"description":"Per-user interest earned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestEarnedResponse"}}}},"400":{"description":"Invalid path or query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bundle address is not present in bundle_registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/users/{addr}/interest-earned":{"get":{"description":"Reads user_daily closes and appends today from user_positions and bundle_state_current. For every bucket, earnings equal position-value delta minus signed net flows. A vault bucket carries `degraded: true` when any contributing close or live projection is degraded; legacy-census closes are boundary-reconstructed derived values, not fabricated exact values. The read path never scans user_flows or contacts Solana RPC. The partner surface is ntbundle-scoped: history for retired legacy Drift vaults without a bundle_registry entry is omitted and reported in excludedBundleKeys.","operationId":"getUserInterestEarned","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read one user’s interest earned across vaults","tags":["Users"],"parameters":[{"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 Solana wallet address","example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92"},"required":true,"description":"Base58 Solana wallet address","in":"path","name":"addr"},{"schema":{"type":"string","format":"date","default":"2026-11-21","description":"Inclusive UTC end date. Defaults to the current UTC date.","example":"2026-07-22"},"required":false,"description":"Inclusive UTC end date. Defaults to the current UTC date.","name":"endDate","in":"query"},{"schema":{"type":"string","enum":["total","daily","monthly"],"default":"total","description":"Bucket size. Total returns one bucket for the selected inclusive UTC range.","example":"monthly"},"required":false,"description":"Bucket size. Total returns one bucket for the selected inclusive UTC range.","name":"granularity","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date. Omit for the full available history.","example":"2026-01-01"},"required":false,"description":"Inclusive UTC start date. Omit for the full available history.","name":"startDate","in":"query"}],"responses":{"200":{"description":"Per-user interest earned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestEarnedResponse"}}}},"400":{"description":"Invalid path or query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/user/{addr}/history":{"get":{"description":"EVM addresses are accepted on EVM vaults. EVM feesPaidCumulative is {token:null,usd:null}; value and earnings remain available. EVM gross and net both use fee-diluted PPS without another per-user fee deduction. Transfers appear in /actions as transfer_in and transfer_out and move net deposits at transfer-time PPS. Returns chronological user_daily position closes and replaces today with a live tick from user_positions × bundle_state_current. Monthly and total points select the final available close rather than summing snapshot balances. Interest-earned fields are inception-to-date cumulative snapshots; Solana users can use /interest-earned for period deltas and never sum them across history points. Rows before 2026-07-03 retain migrated legacy-census semantics; the 2026-07-03 seam row is a start-of-day state; subsequent rollups are UTC daily closes. Every USD leg in a vault point is populated together with priceAsOf or every USD leg is null. Cross-vault USD totals are likewise all-or-nothing. Legacy-census points surface degraded: true because missing high-water-mark evidence makes them boundary reconstructions, not fabricated exact states. Retired registryless vaults are omitted and reported in excludedBundleKeys. The cursor is an opaque chronological keyset; the read path never contacts Solana RPC.","operationId":"listVaultUserPositionHistory","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read one user’s position history for a vault","tags":["Users"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM."},"required":true,"description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM.","name":"addr","in":"path"},{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"},{"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Opaque cursor returned as nextCursor by the previous chronological page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMiIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous chronological page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","default":"2026-11-21","description":"Inclusive UTC end date. Defaults to the current UTC date.","example":"2026-07-22"},"required":false,"description":"Inclusive UTC end date. Defaults to the current UTC date.","name":"endDate","in":"query"},{"schema":{"type":"string","enum":["total","daily","monthly"],"default":"total","description":"Snapshot resolution. Monthly and total select the last available close in each period; snapshot balances are never summed over time.","example":"total"},"required":false,"description":"Snapshot resolution. Monthly and total select the last available close in each period; snapshot balances are never summed over time.","name":"granularity","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date. Omit for the full available history.","example":"2026-01-01"},"required":false,"description":"Inclusive UTC start date. Omit for the full available history.","name":"startDate","in":"query"}],"responses":{"200":{"description":"A chronological page of position history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionHistoryResponse"}}}},"400":{"description":"Invalid path, range, granularity, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bundle address is not present in bundle_registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/users/{addr}/history":{"get":{"description":"EVM addresses are accepted on EVM vaults. EVM feesPaidCumulative is {token:null,usd:null}; value and earnings remain available. EVM gross and net both use fee-diluted PPS without another per-user fee deduction. Transfers appear in /actions as transfer_in and transfer_out and move net deposits at transfer-time PPS. Returns chronological user_daily position closes and replaces today with a live tick from user_positions × bundle_state_current. Monthly and total points select the final available close rather than summing snapshot balances. Interest-earned fields are inception-to-date cumulative snapshots; Solana users can use /interest-earned for period deltas and never sum them across history points. Rows before 2026-07-03 retain migrated legacy-census semantics; the 2026-07-03 seam row is a start-of-day state; subsequent rollups are UTC daily closes. Every USD leg in a vault point is populated together with priceAsOf or every USD leg is null. Cross-vault USD totals are likewise all-or-nothing. Legacy-census points surface degraded: true because missing high-water-mark evidence makes them boundary reconstructions, not fabricated exact states. Retired registryless vaults are omitted and reported in excludedBundleKeys. The cursor is an opaque chronological keyset; the read path never contacts Solana RPC.","operationId":"listUserPositionHistory","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read one user’s position history across vaults","tags":["Users"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM."},"required":true,"description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM.","name":"addr","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Opaque cursor returned as nextCursor by the previous chronological page.","example":"eyJkYXRlIjoiMjAyNi0wNy0yMiIsInZlcnNpb24iOjF9"},"required":false,"description":"Opaque cursor returned as nextCursor by the previous chronological page.","name":"cursor","in":"query"},{"schema":{"type":"string","format":"date","default":"2026-11-21","description":"Inclusive UTC end date. Defaults to the current UTC date.","example":"2026-07-22"},"required":false,"description":"Inclusive UTC end date. Defaults to the current UTC date.","name":"endDate","in":"query"},{"schema":{"type":"string","enum":["total","daily","monthly"],"default":"total","description":"Snapshot resolution. Monthly and total select the last available close in each period; snapshot balances are never summed over time.","example":"total"},"required":false,"description":"Snapshot resolution. Monthly and total select the last available close in each period; snapshot balances are never summed over time.","name":"granularity","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive UTC start date. Omit for the full available history.","example":"2026-01-01"},"required":false,"description":"Inclusive UTC start date. Omit for the full available history.","name":"startDate","in":"query"}],"responses":{"200":{"description":"A chronological page of position history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionHistoryResponse"}}}},"400":{"description":"Invalid path, range, granularity, limit, or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/vault/{id}/user/{addr}/balance":{"get":{"description":"EVM returns feesPaid, hwmPerShare, feeOverrides, lastFeeChargedAt and unpaidFeeEstimate as null; effectiveFees are the vault-level rates. EVM value uses the shared PPS normalized to asset decimals, which already includes vault fee dilution. Reads a user position and live bundle projection without RPC. Any registered Solana ntbundle-program or EVM vault is in scope; catalog_visible does not control inclusion, while retired legacy Drift-program vaults are excluded. Token amounts include exact raw integers and decimal strings. Every Solana devnet asset uses a fixed $1.0 price; other USD fields are omitted when the hourly series has no CoinGecko reference-price tick inside the 3-hour freshness window. On Solana, unpaidFeeEstimate applies projected per-user fee overrides; overrides set before the projection boundary appear after the next continuity census seed. When present, priceAsOf.blockTime is the effective valuation time and priceAsOf.slot is the projection slot that was valued. Because the whole response is one datum, a degraded position or bundle-state projection returns 503.","operationId":"getVaultUserBalance","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read a projected user balance for one vault","tags":["Balances"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM."},"required":true,"description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM.","in":"path","name":"addr"},{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","example":"2bPiNfGc7exUcGkvV5nbsSkuNH3inFU18kgNEkB8fiaT"},"required":true,"description":"Base58 Solana bundle address or EIP-55 0x EVM vault address stored in bundle_registry.bundle_key. Uniform-case EVM input is normalized to its checksum for case-insensitive lookup. bundle_key is globally unique across chains, so a bare id identifies exactly one vault. An optional chain query parameter is reserved for future disambiguation and is not implemented.","in":"path","name":"id"}],"responses":{"200":{"description":"Projected user balance and valuation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultBalanceResponse"}}}},"400":{"description":"Invalid bundle or user Solana address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The registered ntbundle vault or requested user position does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v2/users/{addr}/portfolio":{"get":{"description":"EVM wallet portfolios include registered EVM chains and keep per-user fees null. Any damaged EVM accounting fails the whole response with 503. Reads every registered Solana ntbundle-program or EVM position for a user without RPC. catalog_visible does not control inclusion; retired legacy Drift-program vaults are excluded. Held Solana vaults with a degraded position or bundle-state projection are omitted from vault rows and aggregates and listed by bundle address in unavailableVaults; healthy vaults remain available. Token-native totals are grouped by chain and mint; every Solana devnet asset uses a fixed $1.0 price and valueUsd is omitted when any other included asset has no CoinGecko reference-price tick in the hourly series inside the 3-hour freshness window. On Solana, unpaidFeeEstimate applies each position's projected per-user fee overrides; overrides set before the projection boundary appear after the next continuity census seed. Per-vault rows carry exact cursors; the envelope asOf is the oldest included healthy cursor (the aggregate freshness floor), or the newest registered projection when no healthy held vault is included. priceAsOf.blockTime is the oldest included effective valuation time and priceAsOf.slot is the aggregate projection slot.","operationId":"getUserPortfolio","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"summary":"Read a projected cross-vault user portfolio","tags":["Balances"],"parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}],"example":"GgBaCs3NpeEJ7YhVtQzE9rqwG5azSMPmNJydJVJs2e92","description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM."},"required":true,"description":"Wallet address on the vault chain: base58 for Solana, EIP-55 or uniform-case 0x for EVM.","in":"path","name":"addr"}],"responses":{"200":{"description":"Cross-vault projected portfolio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioResponse"}}}},"400":{"description":"Invalid Solana address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid partner key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Partner rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected service failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required projection state is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"webhooks":{}}