Skip to content

docs: correct quote expiry to 15 minutes in api reference #115

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ScreamingHawk merged 1 commit into from
Sep 17, 2026
Merged

docs: correct quote expiry to 15 minutes in api reference #115

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion api-reference/endpoints/commit-intent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ console.log('Intent committed:', intentId);
## Important Notes

<Warning>
Committed intents must be executed within **10 minutes**. Call `ExecuteIntent` before this window expires or the intent will expire and require a fresh quote.
Committed intents share the quote's expiry — call `ExecuteIntent` within **15 minutes** of the original `QuoteIntent` call. `CommitIntent` does not extend the window; if the quote expires, request a fresh one.
</Warning>

<Info>
Expand Down
6 changes: 6 additions & 0 deletions api-reference/endpoints/execute-intent-edge.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,12 @@ const { intentStatus } = await armResponse.json()
// Step 4: Poll GetIntentReceipt / WaitIntentReceipt for completion.
```

## Timing Requirements

<Warning>
Arm the intent within the quote's expiration window (**15 minutes** from `QuoteIntentEdge`). After arming, the user must complete the edge deposit before the intent's overall expiry, otherwise the intent refunds.
</Warning>

## Errors

| Error | When |
Expand Down
2 changes: 1 addition & 1 deletion api-reference/endpoints/execute-intent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ console.log('Receipt:', receipt);
## Timing Requirements

<Warning>
Call `ExecuteIntent` within the quote's expiration window (**5 minutes** from `QuoteIntent`). If the quote expires before execution, request a new quote and execute again. Legacy callers that committed first have **10 minutes** after `CommitIntent` to execute.
Call `ExecuteIntent` within the quote's expiration window (**15 minutes** from `QuoteIntent`). If the quote expires before execution, request a new quote and execute again. Legacy callers that committed first still share this same quote-expiry window — `CommitIntent` does not extend it.
</Warning>

## Error Handling
Expand Down
2 changes: 1 addition & 1 deletion api-reference/endpoints/quote-intent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ console.log('Quote:', quote);
## Quote Expiration

<Warning>
Quotes expire **5 minutes** after being issued. You must call `ExecuteIntent` (or `ExecuteIntentEdge` for a Solana/Tron origin) before the quote expires, or you'll need to request a new quote.
Quotes expire **15 minutes** after being issued. You must call `ExecuteIntent` (or `ExecuteIntentEdge` for a Solana/Tron origin) before the quote expires, or you'll need to request a new quote.
</Warning>

## Next Steps
Expand Down
8 changes: 4 additions & 4 deletions api-reference/introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ Use `EXACT_INPUT` when you know how much you want to spend, and `EXACT_OUTPUT` w
The `intent` object contains everything needed to execute the intent and the server rejects mutated payloads, so pass it back unchanged.

<Warning>
Quotes expire **5 minutes** after being issued. Call `ExecuteIntent` (or `ExecuteIntentEdge` for Solana/Tron origins) within this window, or request a new quote. Legacy callers that commit first have **10 minutes** after commit to execute.
Quotes expire **15 minutes** after being issued. Call `ExecuteIntent` (or `ExecuteIntentEdge` for Solana/Tron origins) within this window, or request a new quote. Committing first does not extend the window; legacy callers still share the same 15-minute quote expiry.
</Warning>
</Step>

Expand Down Expand Up @@ -536,12 +536,12 @@ Quotes have strict time limits:

| Stage | Time Limit | What Happens |
|-------|------------|--------------|
| Quote validity | 5 minutes | Quote expires, request a new one |
| Quote validity | 15 minutes | Quote expires, request a new one |
| After ExecuteIntent / ExecuteIntentEdge | N/A | Trails handles execution timing |
| Legacy: After CommitIntent | 10 minutes | Must call ExecuteIntent within this window |
| Legacy: After CommitIntent | Shares quote expiry | Must call ExecuteIntent before the original 15-minute window closes |

<Tip>
Always check quote expiration before executing. The `intent.expiresAt` timestamp indicates when the quote becomes invalid.
Always check quote expiration before executing. The `intent.expiresAt` timestamp is the single deadline for calling `ExecuteIntent` (or `ExecuteIntentEdge`), whether or not you committed first.
</Tip>

## Rate Limiting
Expand Down
Loading