Try the Earn lifecycle

The sandbox is a working simulation for product and engineering teams. It creates sample positions and activity without connecting a wallet or moving assets. Use it to understand the response shapes and prototype the Earn journey.

1. Configure the sandbox connection

export THESAUROS_SANDBOX_BASE="https://developer.thesauros.io/api/v1"
export THESAUROS_SANDBOX_KEY="tsk_test_thesauros_sandbox_0000000000000000"

This is the shared sandbox test credential. It does not grant access to a Partner API account. A locally run sandbox exposes the same contract under its configured base URL.

2. Discover available sample vaults

curl --fail-with-body \
  "$THESAUROS_SANDBOX_BASE/vaults?asset=USDC" \
  -H "Authorization: Bearer $THESAUROS_SANDBOX_KEY"

The response contains a list in data. Use the available asset, vault and status fields when building the selection screen.

3. Create a sample position

curl --fail-with-body \
  -X POST "$THESAUROS_SANDBOX_BASE/positions" \
  -H "Authorization: Bearer $THESAUROS_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: earn-example-001" \
  -d '{"wallet":"0x0000000000000000000000000000000000000001","asset":"USDC","amount":1000,"strategy":"auto"}'

Save the returned data.id. The wallet address is an example input; this request does not ask that wallet to sign. Use a new idempotency key for a new intended operation, and reuse the same one when repeating the same request.

4. Inspect the position

Replace the value below with the ID from your response.

export POSITION_ID="your-returned-position-id"

curl --fail-with-body \
  "$THESAUROS_SANDBOX_BASE/positions/$POSITION_ID" \
  -H "Authorization: Bearer $THESAUROS_SANDBOX_KEY"

Follow the principal, current value, accrued yield and status. The position history endpoint provides events that can inform the activity view.

5. Try a withdrawal

curl --fail-with-body \
  -X POST "$THESAUROS_SANDBOX_BASE/positions/$POSITION_ID/withdraw" \
  -H "Authorization: Bearer $THESAUROS_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"all":true}'

Use the returned status and position history to represent the lifecycle in your product. Sandbox state can reset when the process restarts; it is not a persistent customer account.

Continue with your business integration

The Partner API uses a separate contract for attribution, reporting and operations. Start the Partner API quickstart when your account and connection details are available. The environment comparison explains the differences that matter when moving beyond the prototype.