Get Points - Turtle Docs

Overview

GET /v2/streams/points returns points. This is a public endpoint — no API key is required. Use orgId to narrow results to a specific organization. This endpoint is useful when your integration supports point-based streams and needs to list the point assets available for stream creation or reporting. If your organization only creates token-based streams with rewardToken, you do not need to call this endpoint.

Endpoint

curl -X GET "https://earn.turtle.xyz/v2/streams/points?symbol=PTS"

const response = await fetch(
  'https://earn.turtle.xyz/v2/streams/points?symbol=PTS'
);

const data = await response.json();

Query Parameters

uuid

Optional point identifier.

orgId

uuid

Optional organization identifier. When provided, returns only points belonging to that organization.

symbol

string

Optional point symbol filter.

name

string

Optional point name filter.

Response Example

{
  "points": [
    {
      "id": "7ff13cf6-53d0-4f3e-bd1a-e8eab6db4cf1",
      "orgId": "9f51b66a-d13a-4b55-8515-ae6e4ef7cf25",
      "symbol": "PTS",
      "name": "Partner Points",
      "decimals": 18,
      "logoUrl": "https://cdn.example.com/points/pts.png",
      "createdAt": "2026-03-01T00:00:00Z",
      "updatedAt": "2026-03-01T00:00:00Z"
    }
  ]
}

Response Fields

points

Point[]

Array of points matching the provided filters.

See Create Point for the full Point schema.

Important Notes

Points are only relevant for point-based streams

Points are used when creating streams that use pointId as the reward source. They are not required for streams that use rewardToken.

Filters are optional and combinable

You can query by id, orgId, symbol, name, or any combination supported by your integration needs.

Error Handling

Unexpected internal error

Status Code: 500 Internal Server ErrorSolution: Retry the request and contact Turtle if the issue persists.

Create Point Get Tokens

⌘I

​Overview

​Endpoint

​Response Example

​Response Fields

​Important Notes

​Error Handling