GET /v1/vaults/{resourceId}
Get complete vault economics, allocations, liquidity, fees, public metrics, and mobility state
| Availability | Private Preview |
|---|---|
| Method and path | GET /v1/vaults/{resourceId} |
| API version | 1.0.0-private-preview |
| Base URL | https://api.torq.finance |
| Authentication | Anonymous discovery |
| Idempotency | Not declared by this operation. |
| Rate limits | Read x-ratelimit-* and x-request-id response headers. Do not hard-code a quota. |
Request examples
curl -X GET 'https://api.torq.finance/v1/vaults/sample_resourceid' \ -H 'Accept: application/json'
This calls the docs preview and returns sample data shaped by the governed OpenAPI response. It never accepts credentials or changes protocol state.
Run the sample call to inspect a schema-shaped response without credentials or side effects.| Request body | None. |
|---|
Parameters
| Name | In | Required | Type |
|---|---|---|---|
resourceId | path | Yes | string |
fields | query | No | string[] |
Responses
| Status | Meaning | Schema |
|---|---|---|
200 | Successful response | VaultResource |
400 | Invalid request | TorqApiError |
401 | Authentication required | TorqApiError |
403 | Insufficient scope or authority | TorqApiError |
409 | State or idempotency conflict | TorqApiError |
429 | Rate limit exceeded | TorqApiError |
500 | Internal failure | TorqApiError |
200 response schema
VaultResource VaultResource
| Property | Type | Required | Description |
|---|---|---|---|
id | string | No | — |
chainId | integer | No | — |
address | string | No | — |
symbol | string | No | — |
name | string | No | — |
baseAssetAddress | string | No | — |
baseAsset | AssetProfileResource | No | — |
assetSymbol | string | null | No | — |
assetDecimals | integer | null | No | — |
shareClass | string | No | — |
inceptionAt | string | null (date-time) | No | — |
assetManager | ResourceProvider | No | — |
totalAssets | string | null | No | — |
totalSupply | string | null | No | — |
totalAllocatedAssets | string | null | No | — |
idleAssets | string | null | No | — |
tvlUsd | string | null | No | — |
sharePrice | string | null | No | — |
grossApyBps | integer | null | No | — |
netApyBps | integer | null | No | — |
riskScore | integer | null | No | — |
status | string | null | No | — |
depositPolicy | string | null | No | — |
sumsubKycRequired | boolean | null | No | — |
minDepositAssets | string | null | No | — |
maxDepositAssets | string | null | No | — |
listedMarketAddresses | string[] | No | — |
allocations | VaultAllocationResource[] | No | — |
portfolioLiquidity | VaultLiquidityResource | No | — |
exitTerms | object | No | — |
shareMobility | VaultShareMobilityResource | No | — |
publicMetrics | VaultPublicMetricsResource | No | — |
history | VaultHistoryResource[] | No | — |
feeAccruals | object | No | — |
freshness | FreshnessEvidence | No | — |
Inspect nested properties
id string · optional
chainId integer · optional
address string · optional
pattern: ^0x[a-fA-F0-9]{40}$
symbol string · optional
name string · optional
baseAssetAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
baseAsset AssetProfileResource · optional
| Property | Type | Required | Description |
|---|---|---|---|
id | string | null | No | — |
chainId | integer | No | — |
address | string | null | No | — |
symbol | string | null | No | — |
name | string | null | No | — |
decimals | integer | null | No | — |
logoUrl | string | null | No | — |
topCategory | string | null | No | — |
subcategory | string | null | No | — |
economicsTaxonomy | object | No | — |
kycRequired | boolean | null | No | — |
priceUsd | string | null | No | — |
priceAsOf | string | null (date-time) | No | — |
issuer | AssetIssuerProfile | No | — |
Inspect nested properties
id string | null · optional
nullable
chainId integer · optional
address string | null · optional
pattern: ^0x[a-fA-F0-9]{40}$ · nullable
symbol string | null · optional
nullable
name string | null · optional
nullable
decimals integer | null · optional
nullable
logoUrl string | null · optional
nullable
topCategory string | null · optional
nullable
subcategory string | null · optional
nullable
economicsTaxonomy object · optional
kycRequired boolean | null · optional
nullable
priceUsd string | null · optional
nullable
priceAsOf string | null (date-time) · optional
nullable
issuer AssetIssuerProfile · optional
| Property | Type | Required | Description |
|---|---|---|---|
configured | boolean | No | — |
name | string | null | No | — |
website | string | null | No | — |
Inspect nested properties
configured boolean · optional
name string | null · optional
nullable
website string | null · optional
nullable
assetSymbol string | null · optional
nullable
assetDecimals integer | null · optional
nullable
shareClass string · optional
inceptionAt string | null (date-time) · optional
nullable
assetManager ResourceProvider · optional
| Property | Type | Required | Description |
|---|---|---|---|
id | string | null | No | — |
address | string | null | No | — |
name | string | null | No | — |
website | string | null | No | — |
logoUrl | string | null | No | — |
Inspect nested properties
id string | null · optional
nullable
address string | null · optional
pattern: ^0x[a-fA-F0-9]{40}$ · nullable
name string | null · optional
nullable
website string | null · optional
nullable
logoUrl string | null · optional
nullable
totalAssets string | null · optional
pattern: ^[0-9]+$ · nullable
totalSupply string | null · optional
pattern: ^[0-9]+$ · nullable
totalAllocatedAssets string | null · optional
pattern: ^[0-9]+$ · nullable
idleAssets string | null · optional
pattern: ^[0-9]+$ · nullable
tvlUsd string | null · optional
nullable
sharePrice string | null · optional
nullable
grossApyBps integer | null · optional
nullable
netApyBps integer | null · optional
nullable
riskScore integer | null · optional
nullable
status string | null · optional
nullable
depositPolicy string | null · optional
nullable
sumsubKycRequired boolean | null · optional
nullable
minDepositAssets string | null · optional
pattern: ^[0-9]+$ · nullable
maxDepositAssets string | null · optional
pattern: ^[0-9]+$ · nullable
listedMarketAddresses string[] · optional
items string
pattern: ^0x[a-fA-F0-9]{40}$
allocations VaultAllocationResource[] · optional
items VaultAllocationResource
| Property | Type | Required | Description |
|---|---|---|---|
vaultId | string | No | — |
vaultAddress | string | No | — |
marketId | string | No | — |
marketAddress | string | No | — |
listed | boolean | No | — |
approved | boolean | No | — |
allocationEnabled | boolean | No | — |
capAssets | string | null | No | — |
allocatedAssets | string | null | No | — |
allocationBps | integer | null | No | — |
availableMarketLiquidity | string | null | No | — |
marketUtilizationWad | string | null | No | — |
marketBorrowRateAprBps | integer | null | No | — |
marketLendingApyBps | integer | null | No | — |
liquidityProfile | string | null | No | — |
blockNumber | string | null | No | — |
Inspect nested properties
vaultId string · optional
vaultAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
marketId string · optional
marketAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
listed boolean · optional
approved boolean · optional
allocationEnabled boolean · optional
capAssets string | null · optional
pattern: ^[0-9]+$ · nullable
allocatedAssets string | null · optional
pattern: ^[0-9]+$ · nullable
allocationBps integer | null · optional
nullable
availableMarketLiquidity string | null · optional
pattern: ^[0-9]+$ · nullable
marketUtilizationWad string | null · optional
pattern: ^[0-9]+$ · nullable
marketBorrowRateAprBps integer | null · optional
nullable
marketLendingApyBps integer | null · optional
nullable
liquidityProfile string | null · optional
nullable
blockNumber string | null · optional
pattern: ^[0-9]+$ · nullable
portfolioLiquidity VaultLiquidityResource · optional
| Property | Type | Required | Description |
|---|---|---|---|
vaultId | string | No | — |
vaultAddress | string | No | — |
idleAssets | string | null | No | — |
totalAllocatedAssets | string | null | No | — |
immediatelyAvailableAssets | string | null | No | — |
liquidityBufferBps | integer | null | No | — |
baseAssetLockupPeriod | string | null | No | — |
portfolioLockupStatus | string | null | No | — |
longestKnownLockupPeriod | string | null | No | — |
attachedMarketCount | integer | null | No | — |
exposedMarketCount | integer | null | No | — |
unverifiedMarketCount | integer | null | No | — |
exitTermKind | string | null | No | — |
noticeSeconds | string | null | No | — |
intervalSeconds | string | null | No | — |
maturityTimestamp | string | null (date-time) | No | — |
tighteningLocked | boolean | null | No | — |
stressCoverageStatus | string | null | No | — |
durationCompatible | boolean | null | No | — |
blockedReason | string | null | No | — |
marketLiquidity | object[] | No | — |
Inspect nested properties
vaultId string · optional
vaultAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
idleAssets string | null · optional
pattern: ^[0-9]+$ · nullable
totalAllocatedAssets string | null · optional
pattern: ^[0-9]+$ · nullable
immediatelyAvailableAssets string | null · optional
pattern: ^[0-9]+$ · nullable
liquidityBufferBps integer | null · optional
nullable
baseAssetLockupPeriod string | null · optional
nullable
portfolioLockupStatus string | null · optional
nullable
longestKnownLockupPeriod string | null · optional
nullable
attachedMarketCount integer | null · optional
nullable
exposedMarketCount integer | null · optional
nullable
unverifiedMarketCount integer | null · optional
nullable
exitTermKind string | null · optional
nullable
noticeSeconds string | null · optional
pattern: ^[0-9]+$ · nullable
intervalSeconds string | null · optional
pattern: ^[0-9]+$ · nullable
maturityTimestamp string | null (date-time) · optional
nullable
tighteningLocked boolean | null · optional
nullable
stressCoverageStatus string | null · optional
nullable
durationCompatible boolean | null · optional
nullable
blockedReason string | null · optional
nullable
marketLiquidity object[] · optional
items object
exitTerms object · optional
shareMobility VaultShareMobilityResource · optional
| Property | Type | Required | Description |
|---|---|---|---|
vaultId | string | No | — |
vaultAddress | string | No | — |
transferProfile | string | null | No | — |
shareMobilityPaused | boolean | null | No | — |
restoreAfter | string | null (date-time) | No | — |
redeemFreezeReason | string | null | No | — |
systemReason | string | null | No | — |
mobilityEpoch | string | null | No | — |
shareTokens | object[] | No | — |
redemptionQueue | object | No | — |
trustedRecipientPolicy | object | No | — |
walletEligibility | object | No | — |
Inspect nested properties
vaultId string · optional
vaultAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
transferProfile string | null · optional
nullable
shareMobilityPaused boolean | null · optional
nullable
restoreAfter string | null (date-time) · optional
nullable
redeemFreezeReason string | null · optional
nullable
systemReason string | null · optional
nullable
mobilityEpoch string | null · optional
pattern: ^[0-9]+$ · nullable
shareTokens object[] · optional
items object
| Property | Type | Required | Description |
|---|---|---|---|
tokenAddress | string | No | — |
shareClass | string | No | — |
name | string | No | — |
symbol | string | No | — |
decimals | integer | No | — |
transferable | boolean | No | — |
supportsAllowance | boolean | No | — |
supportsAdapters | boolean | No | — |
totalSupply | string | null | No | — |
redemptionQueue object · optional
trustedRecipientPolicy object · optional
walletEligibility object · optional
publicMetrics VaultPublicMetricsResource · optional
| Property | Type | Required | Description |
|---|---|---|---|
averageRedemptionSettlementSeconds | integer | null | No | — |
averageRedemptionSampleSize | integer | null | No | — |
estimateModelVersion | string | null | No | — |
largestWithdrawal30dAssets | string | null | No | — |
largestWithdrawal30dTransactionHash | string | null | No | — |
largestWithdrawal30dTimestampMs | string | null | No | — |
ecosystemConcentrationMarketAddress | string | null | No | — |
ecosystemConcentrationBps | integer | null | No | — |
ecosystemExposure | object[] | No | — |
queueStatus | object | No | — |
truthSource | string | null | No | — |
Inspect nested properties
averageRedemptionSettlementSeconds integer | null · optional
nullable
averageRedemptionSampleSize integer | null · optional
nullable
estimateModelVersion string | null · optional
nullable
largestWithdrawal30dAssets string | null · optional
pattern: ^[0-9]+$ · nullable
largestWithdrawal30dTransactionHash string | null · optional
nullable
largestWithdrawal30dTimestampMs string | null · optional
pattern: ^[0-9]+$ · nullable
ecosystemConcentrationMarketAddress string | null · optional
pattern: ^0x[a-fA-F0-9]{40}$ · nullable
ecosystemConcentrationBps integer | null · optional
nullable
ecosystemExposure object[] · optional
items object
queueStatus object · optional
truthSource string | null · optional
nullable
history VaultHistoryResource[] · optional
items VaultHistoryResource
| Property | Type | Required | Description |
|---|---|---|---|
vaultId | string | No | — |
vaultAddress | string | No | — |
interval | string | No | — |
bucketStart | string | null (date-time) | No | — |
bucketEnd | string | null (date-time) | No | — |
sharePrice | string | null | No | — |
netApyBps | integer | null | No | — |
totalAssets | string | null | No | — |
totalAllocatedAssets | string | null | No | — |
idleAssets | string | null | No | — |
tvlUsd | string | null | No | — |
blockNumber | string | null | No | — |
Inspect nested properties
vaultId string · optional
vaultAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
interval string · optional
bucketStart string | null (date-time) · optional
nullable
bucketEnd string | null (date-time) · optional
nullable
sharePrice string | null · optional
nullable
netApyBps integer | null · optional
nullable
totalAssets string | null · optional
pattern: ^[0-9]+$ · nullable
totalAllocatedAssets string | null · optional
pattern: ^[0-9]+$ · nullable
idleAssets string | null · optional
pattern: ^[0-9]+$ · nullable
tvlUsd string | null · optional
nullable
blockNumber string | null · optional
pattern: ^[0-9]+$ · nullable
feeAccruals object · optional
| Property | Type | Required | Description |
|---|---|---|---|
managementFeeRateBps | integer | null | No | — |
performanceFeeRateBps | integer | null | No | — |
borrowerManagerFeeRateBps | integer | null | No | — |
resellerFeeRateBps | integer | null | No | — |
accruedManagementFeeAssets | string | null | No | — |
accruedPerformanceFeeAssets | string | null | No | — |
accruedBorrowerManagerFeeAssets | string | null | No | — |
accruedResellerFeeAssets | string | null | No | — |
Inspect nested properties
managementFeeRateBps integer | null · optional
nullable
performanceFeeRateBps integer | null · optional
nullable
borrowerManagerFeeRateBps integer | null · optional
nullable
resellerFeeRateBps integer | null · optional
nullable
accruedManagementFeeAssets string | null · optional
pattern: ^[0-9]+$ · nullable
accruedPerformanceFeeAssets string | null · optional
pattern: ^[0-9]+$ · nullable
accruedBorrowerManagerFeeAssets string | null · optional
pattern: ^[0-9]+$ · nullable
accruedResellerFeeAssets string | null · optional
pattern: ^[0-9]+$ · nullable
freshness FreshnessEvidence · optional
| Property | Type | Required | Description |
|---|---|---|---|
status | enum | Yes | — |
lagSeconds | integer | Yes | — |
blockNumber | string | null | No | — |
blockTimestamp | string | null (date-time) | No | — |
projectedAt | string | null (date-time) | No | — |
snapshotAt | string | null (date-time) | No | — |
reason | string | null | No | — |
Inspect nested properties
status enum · required
one of: current, healthy, stale, missing, blocked
lagSeconds integer · required
minimum: 0
blockNumber string | null · optional
nullable
blockTimestamp string | null (date-time) · optional
nullable
projectedAt string | null (date-time) · optional
nullable
snapshotAt string | null (date-time) · optional
nullable
reason string | null · optional
nullable
400, 401, 403, 409, 429, 500 response schema
TorqApiError TorqApiError
| Property | Type | Required | Description |
|---|---|---|---|
ok | boolean | Yes | — |
code | string | Yes | — |
message | string | Yes | — |
requestId | string | Yes | — |
retryable | boolean | Yes | — |
blockedReason | string | null | No | — |
docsUrl | string (uri) | No | — |
Inspect nested properties
ok boolean · required
code string · required
minimum length: 1 · maximum length: 200
message string · required
minimum length: 1 · maximum length: 200
requestId string · required
minimum length: 1 · maximum length: 200
retryable boolean · required
blockedReason string | null · optional
nullable
docsUrl string (uri) · optional
Related guides
- Authentication and scopes
- Errors, idempotency, and rate limits
- Canonical state and final completion
- SDK reference
For retry behavior and blocked-state handling, see Errors and rate limits.