Skip to content

GET /v1/vaults/{resourceId}

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

terminal
curl -X GET 'https://api.torq.finance/v1/vaults/sample_resourceid' \
  -H 'Accept: application/json'
Run a safe sample

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

resourceId
path
Yes
string
fields
query
No
string[]

Responses

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

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
—
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

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
—
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

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

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

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
—
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

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
—
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

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
—
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

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

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
—
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

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
—
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

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

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

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

For retry behavior and blocked-state handling, see Errors and rate limits.