Distributor Activity

All requests require an API key via the X-API-Key header. See Authentication for details.

Overview

GET /v2/deposit/{distributorId} Retrieve paginated deposit activity attributed to a specific distributor. Results are ordered by date descending. You can filter by opportunity or product to narrow results. This is the API behind the deposit feed in the Distribution Dashboard.

Looking for wallet-scoped activity across all distributors? See Wallet Activity for deposits and withdrawals by wallet address. To choose between the three views, see the Portfolio & Activity overview.

Endpoint

Get Distributor Activity

curl -X GET "https://earn.turtle.xyz/v2/deposit/your-distributor-id?page=1&limit=20" \
  -H "X-API-Key: pk_live_xxxxx"

const response = await fetch(
  'https://earn.turtle.xyz/v2/deposit/your-distributor-id?page=1&limit=20',
  { headers: { 'X-API-Key': 'pk_live_xxxxx' } }
);
const data = await response.json();

Path Parameters

string

required

The unique identifier of the distributor to retrieve deposits for.

Query Parameters

uuid

Filter deposits to a specific opportunity.

uuid

Filter deposits to opportunities belonging to a specific product. When combined with opportunityId, the opportunity must belong to the product; otherwise an empty page is returned.

integer

default:"1"

Page number for pagination.

integer

default:"20"

Number of deposits per page (max: 100).

Response Example

{
  "deposits": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "opportunityId": "550e8400-e29b-41d4-a716-446655440000",
      "interaction": "deposit",
      "txHash": "0xedfdf71e0e4daec5afcb87988821a8bccd5c282647c8e81a65a71181a44a8e51",
      "chainId": 1,
      "blockTimestamp": "2025-10-08T16:18:07Z",
      "walletAddress": "0xe84ef330b7b5c02fb3fbe05f2a31cb331c2b874c",
      "amountToken": "89.704738",
      "amountInUsd": "89.73",
      "tokenSymbol": "USDC",
      "tokenIconUrl": "https://icons.llama.fi/usd-coin.jpg",
      "isSwap": false
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 142,
    "totalPages": 8,
    "hasNext": true,
    "hasPrevious": false
  }
}

Response Fields

array

Array of deposit activity items.

uuid

Unique identifier for the interaction record.

uuid

The opportunity the deposit was made into.

string

Interaction type. Always deposit for this endpoint.

string

On-chain transaction hash.

integer

Chain ID where the transaction was executed.

string

UTC timestamp of the block containing the transaction (ISO 8601).

string

The depositor’s wallet address.

string

Deposit amount in token units (human-readable). May be absent if token metadata is unavailable.

string

Deposit amount in USD. May be absent if price data is unavailable.

string

Symbol of the deposited token (e.g., USDC). May be absent if token metadata is unavailable.

string

URL to the token’s icon. May be absent.

boolean

Whether the deposit used swap mode.

object

Pagination metadata.

integer

Current page number.

integer

Results per page.

integer

Total number of matching deposits.

integer

Total number of pages.

boolean

Whether a next page exists.

boolean

Whether a previous page exists.

Filter by product

Retrieve deposits scoped to a specific product and its associated opportunities.

const response = await fetch(
  `https://earn.turtle.xyz/v2/deposit/${distributorId}?productId=${productId}&page=1&limit=50`,
  { headers: { 'X-API-Key': 'pk_live_xxxxx' } }
);
const { deposits, pagination } = await response.json();

Paginate through all deposits

const getAllDeposits = async (distributorId: string) => {
  const all = [];
  let page = 1;

  while (true) {
    const response = await fetch(
      `https://earn.turtle.xyz/v2/deposit/${distributorId}?page=${page}&limit=100`,
      { headers: { 'X-API-Key': 'pk_live_xxxxx' } }
    );
    const { deposits, pagination } = await response.json();
    all.push(...deposits);

    if (!pagination.hasNext) break;
    page++;
  }

  return all;
};

Error Handling

Distributor not found

Status Code: 404 Not Found

{
  "error": {
    "status": "NOT_FOUND",
    "error": "distributor not found"
  }
}

Solution: Verify your distributor ID is correct and active.

Invalid opportunityId or productId

Status Code: 400 Bad Request

{
  "error": {
    "status": "INVALID_ARGUMENT",
    "error": "invalid opportunityId: not-a-uuid"
  }
}

Solution: Both opportunityId and productId must be valid UUIDs.

Get Started

Products

Reference

Overview

Endpoint

Get Distributor Activity

Path Parameters

Query Parameters

Response Example

Response Fields

Filter by product

Paginate through all deposits

Error Handling

​Overview

​Endpoint

​Get Distributor Activity

​Path Parameters

​Query Parameters

​Response Example

​Response Fields

​Filter by product

​Paginate through all deposits

​Error Handling

Overview

Endpoint

Get Distributor Activity

Path Parameters

Query Parameters

Response Example

Response Fields

Filter by product

Paginate through all deposits

Error Handling