GET /v1/positions
List positions
| Availability | Private Preview |
|---|---|
| Method and path | GET /v1/positions |
| 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
PublishableKeyWalletSessionSecretKey
Request examples
curl -X GET 'https://api.torq.finance/v1/positions' \ -H 'Accept: application/json' \ -H 'x-torq-publishable-key: $TORQ_PUBLISHABLE_KEY' \ -H 'x-torq-wallet-session: $TORQ_WALLET_SESSION'
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
| Status | Meaning | Schema |
|---|---|---|
200 | Successful response | PositionResourceCollection |
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
PositionResourceCollection PositionResourceCollection
| Property | Type | Required | Description |
|---|---|---|---|
items | PositionResource[] | Yes | — |
pageInfo | PageInfo | Yes | — |
freshness | FreshnessEvidence | Yes | — |
Inspect nested properties
items PositionResource[] · required
items PositionResource
| Property | Type | Required | Description |
|---|---|---|---|
marketId | string | No | — |
chainId | integer | No | — |
marketAddress | string | No | — |
walletAddress | string | No | — |
collateralAssets | string | null | No | — |
debtAssets | string | null | No | — |
debtShares | string | null | No | — |
maxBorrowableAssets | string | null | No | — |
healthFactorWad | string | null | No | — |
liquidatable | boolean | null | No | — |
monitorState | string | null | No | — |
Inspect nested properties
marketId string · optional
chainId integer · optional
marketAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
walletAddress string · optional
pattern: ^0x[a-fA-F0-9]{40}$
collateralAssets string | null · optional
pattern: ^[0-9]+$ · nullable
debtAssets string | null · optional
pattern: ^[0-9]+$ · nullable
debtShares string | null · optional
pattern: ^[0-9]+$ · nullable
maxBorrowableAssets string | null · optional
pattern: ^[0-9]+$ · nullable
healthFactorWad string | null · optional
pattern: ^[0-9]+$ · nullable
liquidatable boolean | null · optional
nullable
monitorState string | null · optional
nullable
pageInfo PageInfo · required
| Property | Type | Required | Description |
|---|---|---|---|
hasMore | boolean | Yes | — |
nextCursor | string | null | Yes | — |
Inspect nested properties
hasMore boolean · required
nextCursor string | null · required
nullable
freshness FreshnessEvidence · required
| 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.