Skip to content

Explore Build Leaderboard Vault Agents

Quick Links

Forest Docs Creator Playbook Forest Playkit Quickstart Whitepaper

Getting Started

Technical Documentation

Agents

Get agent details GET List agent sessions GET Create a new agent session POST Get session details GET List session messages GET Send a message to the agent POST Retry a message previously sent to the agent PUT Stream agent session events GET

App Templates

List app templates GET Get an app template GET

Assets

Search Assets GET

Auth

Generate a nonce POST Verify a user's signature POST Refresh user's access token POST Logout user POST

Oauth

Review fixed Forest Harness consent GET Allow or deny Forest Harness consent POST Exchange a code or rotate a refresh token POST Revoke a Harness OAuth session using any of its refresh tokens POST

Builder

Get builder credit balance GET Claim a confirmed credit purchase POST List builder sessions GET Create a new builder session POST Get builder session GET Trash a builder session DELETE Stream builder session events GET Send a builder prompt POST Retry a builder prompt POST

Buyback

Get next buyback execution time GET Get buyback history for a token GET

Competitions

Get competitions GET Get competition reward stats GET Get competition data by id GET Get user leaderboard stats GET

Me

Get current user GET Get current user username settings GET Set the current user username PATCH Get or generate the current user referral code GET Get referral stats (seeds earned + referees count) GET Claim being referred by another user POST Mark welcome flow as dismissed POST List current user tokens GET Get portfolio overview GET Get recent portfolio activity GET

News

List News GET Get news by slug GET

Ongoing Events

List ongoing events GET

Coin Flip

Get settings GET Make a bet POST Get bet history GET

Game

Get game balance GET Record a deposit POST Record a vault fund POST Register a Game Vault for an external token POST Request a claim POST Confirm claim result POST Release claim reservation POST Get player game transactions GET Get player burns GET Get player burn summary GET Get vault funding transactions GET

Html

Get HTML settlement secret status GET Create or rotate HTML settlement secret POST Get settings GET Get public playable state GET Submit an HTML game settlement POST Redeem an identity code POST Submit a signed HTML game burn POST Execute an HTML swap session POST Authorize an HTML game action POST Issue a single-use identity code POST Invoke generated HTML runtime method POST

Lucky Reel

Get settings GET Make a bet POST Get bet history GET

Runtime Sessions

Create Session Source Runtime Session POST

Runtime

Get Source Runtime GET Invoke Source Runtime POST

Playables

Authorize for the project POST

Job Runs

List recent scheduled job runs GET

Publication

Prepare a game for launch POST Publish a game POST

Releases

List Project Releases GET Accept an immutable release Release POST Preview a Published Game Update GET Get a Project Release GET

Remix Launch

Sign the project token launch fee POST Read the remix parent payout GET

Project Remix

Find published games to remix by link, ID, address, symbol or name GET Download a published project for remixing GET

Updates

Publish a reviewed game code update POST

Projects

Check your game before launch GET Import an existing ERC-20 for your draft game POST List projects GET Create a project POST Get a project GET Update a project PATCH Delete a project DELETE Update project authoring metadata PATCH Upload project image POST Set the card image of a source project PUT Batch upload project images POST

Quests

List active quests for a namespace GET Claim a quest reward POST

Vault

List auctions GET Get auction detail GET Get auction bidders GET Get aggregated chart data for an auction GET Get auction activity feed GET Place or increase a bid POST Get current user position GET Request claim signature for auction rewards POST

Seeds

Get seed balance for current user GET Get seed ledger activity for current user GET

Swap Sessions

Get project swap sessions GET Get project swap-session executor wallet GET Request a swap session transaction POST Create a swap session POST Get current user swap session GET Confirm swap session revoke POST

Tokens

Quote a swap for an external token GET Build the swap transaction for an external token GET Import an existing ERC-20 as your draft token POST List tokens GET Create a token POST Get token stats GET Get the active token launch contracts GET Get a token GET Update a token PATCH Delete a token DELETE Get external asset market snapshot GET Get latest external asset trades GET Get external asset OHLCV in whole quote units GET Permanently reserve a Forest token launch identity POST Authorize a standalone token liquidity pool POST Get token derived stats GET Get token holders GET Update draft token details and tokenomics PATCH

Pairs

List pairs GET Search pairs GET Get a pair GET Get OHLCV candles for a pair GET Get recent swaps for a pair GET Get History Pair GET

Retry a builder prompt POST

Checks the credit gate and retries a failed token-builder prompt.

Get buyback history for a token GET

Next Page

Explore Build Leaderboard Vault Agents

API Reference Get next buyback execution time GET

Get next buyback execution time

GET

/buyback/next-execution

Response Body

`application/json`

curl -X GET "https://example.com/buyback/next-execution"

{}