GET /v1/funds/{resourceId}/epochs

Availability	Private Preview
Method and path	`GET /v1/funds/{resourceId}/epochs`
API version	`1.0.0-private-preview`
Base URL	`https://api.torq.finance`
Authentication	PublishableKey, 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
SecretKey

Request examples

terminal

curl -X GET 'https://api.torq.finance/v1/funds/sample_resourceid/epochs' \
  -H 'Accept: application/json' \
  -H 'x-torq-publishable-key: $TORQ_PUBLISHABLE_KEY'

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

Name	In	Required	Type
`resourceId`	path	Yes	`string`

Responses

Status	Meaning	Schema
`200`	Successful response	`FundEpochResourceCollection`
`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

FundEpochResourceCollection FundEpochResourceCollection

Property	Type	Required	Description
`items`	`FundEpochResource[]`	Yes	—
`pageInfo`	`PageInfo`	Yes	—
`freshness`	`FreshnessEvidence`	Yes	—

Inspect nested properties

items FundEpochResource[] · required

items FundEpochResource

Property	Type	Required	Description
`id`	`string`	No	—
`fundAddress`	`string`	No	—
`epochId`	`string \| null`	No	—
`status`	`string`	No	—
`quoteAssetAddress`	`string \| null`	No	—
`quoteAssetDecimals`	`integer \| null`	No	—
`openedAt`	`string \| null`	No	—
`scheduledCloseAt`	`string \| null`	No	—
`closedAt`	`string \| null`	No	—
`postCloseFundingDeadline`	`string \| null`	No	—
`depositedQuoteAmount`	`string \| null`	No	—
`withdrawnQuoteAmount`	`string \| null`	No	—
`activeScaleRay`	`string \| null`	No	—
`activeReservationId`	`string \| null`	No	—
`fundedSidePocketCount`	`integer \| null`	No	—
`blockNumber`	`string \| null`	No	—

Inspect nested properties

id string · optional

fundAddress string · optional

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

epochId string | null · optional

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

status string · optional

quoteAssetAddress string | null · optional

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

quoteAssetDecimals integer | null · optional

nullable

openedAt string | null · optional

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

scheduledCloseAt string | null · optional

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

closedAt string | null · optional

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

postCloseFundingDeadline string | null · optional

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

depositedQuoteAmount string | null · optional

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

withdrawnQuoteAmount string | null · optional

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

activeScaleRay string | null · optional

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

activeReservationId string | null · optional

nullable

fundedSidePocketCount integer | null · optional

nullable

blockNumber string | null · optional

pattern: ^[0-9]+$ · 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

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