Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: thirdtrail Utility API
version: 1.0.0
description: 'High-precision sun, moon, twilight, solar-irradiance and tide data for any point on Earth — with elevation as a first-class input.
All endpoints take `Authorization: Bearer `. Responses are shaped by the caller''s plan: features a plan does not include are omitted from the response rather than erroring.
Not for navigation or life-safety use — see https://thirdtrail.life/safety/'
servers:
- url: https://thirdtrail.life
description: Production
tags:
- name: Utility
description: Connectivity and key-verification helpers.
paths:
/v1/echo/:
get:
operationId: echo_retrieve
description: Returns your request unchanged. Use it to verify a key works and to check connectivity without consuming a data computation.
summary: Echo a request back
tags:
- Utility
security:
- bearerAuth: []
- cookieAuth: []
responses:
'200':
description: No response body
/v1/hash/:
get:
operationId: hash_retrieve
description: Deterministic hash helper. Chiefly a zero-risk endpoint for testing rate limits and key handling.
summary: Hash a string
tags:
- Utility
security:
- bearerAuth: []
- cookieAuth: []
responses:
'200':
description: No response body
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Your API key, as `Authorization: Bearer tt_live_…`. Keys are minted in the dashboard and shown once — store it in a secret manager. The key determines your plan, and the plan shapes what each response contains.'
cookieAuth:
type: apiKey
in: cookie
name: sessionid