Skip to content

GET /v1/allocation-intelligence

Availability
Private Preview
Method and path
GET /v1/allocation-intelligence
API version
1.0.0-private-preview
Base URL
https://api.torq.finance
Authentication
PublishableKey, WalletSession, SecretKey
Idempotency
Not declared by this operation.
Rate limits
Read x-ratelimit-* and x-request-id response headers. Do not hard-code a quota.

Authentication requirements

  • PublishableKey
  • WalletSession
  • SecretKey

Request examples

terminal
curl -X GET 'https://api.torq.finance/v1/allocation-intelligence' \
  -H 'Accept: application/json' \
  -H 'x-torq-publishable-key: $TORQ_PUBLISHABLE_KEY' \
  -H 'x-torq-wallet-session: $TORQ_WALLET_SESSION'
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.

Responses

200
Successful response
AllocationIntelligenceResourceCollection
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

AllocationIntelligenceResourceCollection AllocationIntelligenceResourceCollection

items
AllocationIntelligenceResource[]
Yes
—
pageInfo
PageInfo
Yes
—
freshness
FreshnessEvidence
Yes
—
Inspect nested properties

items AllocationIntelligenceResource[] · required

items AllocationIntelligenceResource

id
string
No
—
profileId
string
No
—
status
string
No
—
action
string
No
—
targetVaultAddress
string | null
No
—
targetMarketAddress
string | null
No
—
amountAssets
string | null
No
—
confidenceBps
integer | null
No
—
policyVersion
string | null
No
—
modelVersion
string | null
No
—
Inspect nested properties

id string · optional

profileId string · optional

status string · optional

action string · optional

targetVaultAddress string | null · optional

pattern: ^0x[a-fA-F0-9]{40}$ · nullable

targetMarketAddress string | null · optional

pattern: ^0x[a-fA-F0-9]{40}$ · nullable

amountAssets string | null · optional

pattern: ^[0-9]+$ · nullable

confidenceBps integer | null · optional

nullable

policyVersion string | null · optional

nullable

modelVersion string | null · optional

nullable

projectionStatus string | null · optional

nullable

txHash string | null · optional

nullable

createdAt string | null (date-time) · optional

nullable

pageInfo PageInfo · required

hasMore
boolean
Yes
—
nextCursor
string | null
Yes
—
Inspect nested properties

hasMore boolean · required

nextCursor string | null · required

nullable

freshness FreshnessEvidence · required

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.