Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

X Tracker

Follow X accounts in real time, organize them in lists, and research tweets for token deploys.

The X Tracker is an admin-only workspace that streams posts, follows and profile changes from a set of X accounts, so an operator can react to a tweet and deploy a token from it. One shared session tracks one set of accounts for every admin; each admin keeps their own lists (named subsets of those accounts) and their own settings document.

The live feed is a server-sent event stream. Saved tweets fill the feed on load. Around it, research endpoints relay third-party services through the backend: Frontrun for X search and profile reports, FxTwitter for single tweets, and Serper for Google image search, plus name/ticker suggestions and image analysis used by the deploy flow.

All endpoints require an admin account. The web app shows the page as X Tracker at /tracker.

An X account followed by the shared tracker session.

Attributes

  • handle string
    X handle, lowercase, without @.
  • displayName string | null
    Account display name.
  • isActive boolean
    Whether the session is currently tracking the account.
  • twitterUserId string | null
    Numeric X user ID as a string.

A named subset of the tracked accounts, shown as its own feed. Lists belong to the caller.

Attributes

  • id string
    Unique identifier.
  • name string
    List name.
  • handles array<string>
    Handles in the list.
  • position integer
    Sort position; the app orders lists by it.
  • icon string | null
    Icon name from the tracker's icon set.
  • color string | null
    Color as #rrggbb.

A tweet event stored by the tracker: the realtime payload as received, with its delivery time and suggestions.

Attributes

  • event object
    Raw realtime payload (the d of a stream event message).
  • received_at integer
    Time the backend received the event, in Unix milliseconds.
  • deleted boolean
    Whether the tweet was deleted since.
  • suggestions array<object> | null
    Suggestions for the tweet; null until they are made.

A token name and ticker proposed for a tweet.

Attributes

  • name string
    Token name.
  • symbol string
    Ticker.
  • image string | null
    Image URL to use, or null.

Stream tracker events

Admin JWT internal
GET /tracker/stream

Opens a server-sent event stream of the shared tracker session.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The response is text/event-stream. Events are separated by a blank line (\n\n); the client keeps only data: lines, strips the prefix, joins multi-line data with \n, and parses the result as JSON. Each message has a type:

  • status: session state, with status, error, latency and session.
  • event: one realtime event in d. d.event is twitter.post.new, twitter.post.update, twitter.following.new, twitter.following.removed, twitter.follower.new, twitter.profile.update or twitter.tweet.deleted; d.task_info.handle names the tracked account and d.data carries the event data.
  • handles: the tracked set changed; reload List tracked accounts.
  • suggestions: name/ticker suggestions ready for tweet_id.
  • lagged: skipped events were dropped.

The SDK makes a raw fetch with the bearer token and returns the Response; the caller reads and closes the body. On 401 or 403 the app stops and reports that the tracker is restricted to admins. On any other failure or end of stream it reconnects with exponential backoff capped at 30 seconds.

Parameters

No parameters.

Returns 200 OK · text/event-stream

A stream of data: events, each a JSON message.

  • type enum
    Message type.
    Possible values statuseventhandlessuggestionslagged
  • status enum
    On status: state of the upstream session.
    Possible values idleconnectingauthenticatingconnectedreconnectingerror
  • error string | null
    On status: error message, if any.
  • latency number | null
    On status: latency reported by the session.
  • session object | null
    On status: session details.
    Child attributes 3
    • modules array<string>
      Modules enabled on the session.
    • handles integer | null
      Accounts tracked.
    • maxHandles integer | null
      Maximum accounts the session can track.
  • d object
    On event: the raw realtime payload.
    Child attributes 7
    • event string
      Event name, e.g. twitter.post.new.
    • event_id string
      Event identifier.
    • event_time integer
      Event time in Unix milliseconds.
    • task_info object
      { handle } of the tracked account.
    • data object
      Event data: the tweet, the followed account, the profile change or the deleted tweet.
    • replayed boolean
      The event is a replay; the app does not notify for it.
    • delayed boolean
      The event arrived late.
  • tweet_id string
    On suggestions: the tweet the suggestions are for.
  • suggestions array<object>
    On suggestions: Suggestion objects.
  • skipped integer
    On lagged: number of events skipped. The app ignores this message.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. The web app stops reconnecting on this status, as it does on 401. Call it with an admin account's session.
422 upstream_failure The server has no Xanguard key, so there is no session to stream. Set XANGUARD_API_KEY on the server, or retry later.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.stream(signal) src/lib/proxima/endpoints/tracker.ts

List tracked accounts

Admin JWT internal
GET /tracker/handles

Lists the X accounts followed by the shared tracker session.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The SDK returns the handles array.

Parameters

No parameters.

Returns 200 OK · application/json

Returns a list of Tracked handle objects.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 upstream_failure The server has no Xanguard key, or the Xanguard API failed. Set XANGUARD_API_KEY on the server, or retry later.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.handles() src/lib/proxima/endpoints/tracker.ts

Track an account

Admin JWT internal
POST /tracker/handles

Adds an X account to the shared tracker session.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat answers 409 once the account is tracked; List tracked accounts shows the current set.

The web app normalizes input before sending: it strips a leading @ and an x.com or twitter.com URL prefix, drops anything after /, ? or #, and lowercases. The SDK returns the stored handle. Bulk import sends one request per handle.

Body parameters application/json

  • handle string Required
    X handle, without @.

Returns 200 OK · application/json

  • handle string
    Handle as stored.

Errors

StatusCodeWhen and what to do
400 bad_request handle does not reduce to an X handle of 1 to 50 letters, digits or _. Send @name, name or an x.com profile link.
400 bad_request Xanguard refused the handle, with its own message. Bulk import skips it and continues.
403 forbidden The tracking limit of the Xanguard plan is reached, with Xanguard's own message. Bulk import stops here. Stop tracking an account with Stop tracking an account first.
403 forbidden The caller is not an admin. Call it with an admin account's session.
404 not_found Xanguard does not know this X account. Bulk import skips it and continues. Check the handle on X.
409 conflict The account is already tracked. Bulk import skips it and continues. Nothing to do: the account is already tracked.
422 upstream_failure The server has no Xanguard key, or the Xanguard API failed. Set XANGUARD_API_KEY on the server, or retry later.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.addHandle(handle) src/lib/proxima/endpoints/tracker.ts

Stop tracking an account

Admin JWT internal
DEL /tracker/handles/{handle}

Removes an X account from the shared tracker session.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat after a success may answer an error relayed from Xanguard; List tracked accounts shows the current set.

Path parameters

  • handle string Required
    X handle, without @.
    Exampledemo_trader

Returns 200 OK · application/json

The web app does not read the response body.

Errors

StatusCodeWhen and what to do
400 bad_request handle is not a valid X handle. Send @name, name or an x.com profile link.
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 upstream_failure The server has no Xanguard key, or the Xanguard API failed. Set XANGUARD_API_KEY on the server, or retry later.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.removeHandle(handle) src/lib/proxima/endpoints/tracker.ts

List saved tweets

Admin JWT internal
GET /tracker/tweets

Returns stored tweets of the given accounts, used to fill the feed on load.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The web app requests each viewed account once, in batches of 40 handles with per_handle=100. The SDK returns the tweets array. Saved suggestions are merged into the feed.

Query parameters

  • handles string Optional
    Comma-separated handles.
    Exampleexamplecaller,demo_trader
  • per_handle integer Optional
    Maximum tweets per handle.
    Example100
  • limit integer Optional
    Maximum tweets in total.

Returns 200 OK · application/json

Returns a list of Saved tweet objects.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. The app stays silent instead of showing an error. Call it with an admin account's session.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.tweets({ handles, perHandle, limit }) src/lib/proxima/endpoints/tracker.ts

Retrieve tracker settings

Admin JWT internal
GET /tracker/settings

Returns the caller's saved tracker settings document.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The document is free-form JSON owned by the client. The web app stores feed (sound, showMedia, detectVision, maxDepth), per-account prefs, keyword alerts, activeList, defaultList, deploy presets and layout. The SDK returns settings. If loading fails, the app disables saving so stored settings are never overwritten with defaults.

Parameters

No parameters.

Returns 200 OK · application/json

  • settings object | null
    Saved document, or null when nothing is saved.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. Call it with an admin account's session.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.settings() src/lib/proxima/endpoints/tracker.ts

Save tracker settings

Admin JWT internal
PUT /tracker/settings

Replaces the caller's tracker settings document.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry The body replaces the saved settings whole.

The web app saves 800 ms after the last change, and only when the document differs from the last saved copy.

Body parameters application/json

  • settings object Required
    The full settings document.

Returns 200 OK · application/json

The web app does not read the response body.

Errors

StatusCodeWhen and what to do
400 bad_request settings is not a JSON object. Send settings as an object.
400 bad_request settings is larger than 256 KB once serialized. Trim the settings below 256 KB.
403 forbidden The caller is not an admin. Call it with an admin account's session.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.saveSettings(settings) src/lib/proxima/endpoints/tracker.ts

List tracker lists

Admin JWT internal
GET /tracker/lists

Lists the caller's tracker lists.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The SDK returns the lists array; the app sorts it by position.

Parameters

No parameters.

Returns 200 OK · application/json

Returns a list of Tracker list objects.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. Call it with an admin account's session.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.lists() src/lib/proxima/endpoints/tracker.ts

Create a list

Admin JWT internal
POST /tracker/lists

Creates a tracker list from a name and a set of tracked handles.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Check before retrying A repeat creates a second list with the same name. Look for it in List tracker lists first.

Body parameters application/json

  • name string Required
    List name.
  • handles array<string> Required
    Handles in the list.
  • icon string | null Optional
    Icon name.
  • color string | null Optional
    Color as #rrggbb.

Returns 200 OK · application/json

Returns the created Tracker list.

Errors

StatusCodeWhen and what to do
400 bad_request The caller already has 50 lists. Free a slot with Delete a list first.
400 bad_request name is empty or longer than 40 characters. Send a name of 1 to 40 characters.
400 bad_request icon is longer than 32 characters or has characters other than ASCII letters and digits. Send an icon name from the app's icon set, or an empty string to clear it.
400 bad_request color is not a #rrggbb hex color. Send a color such as #1d9bf0, or an empty string to clear it.
400 bad_request An entry in handles is not a valid X handle. Send @name, name or an x.com profile link.
403 forbidden The caller is not an admin. Call it with an admin account's session.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.createList(name, handles, style) src/lib/proxima/endpoints/tracker.ts

Update a list

Admin JWT internal
PATCH /tracker/lists/{list_id}

Updates a list's name, handles, position, icon or color.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry

Only the fields sent change. To clear icon or color, send an empty string; the SDK turns a null into "".

Path parameters

  • list_id string Required
    List ID.
    Example67744a28-e685-49cd-a56b-803b8e647080

Body parameters application/json

  • name string Optional
    New name.
  • handles array<string> Optional
    New set of handles.
  • position integer Optional
    New sort position.
  • icon string Optional
    Icon name, or "" to clear.
  • color string Optional
    Color as #rrggbb, or "" to clear.

Returns 200 OK · application/json

Returns the updated Tracker list.

Errors

StatusCodeWhen and what to do
400 bad_request name is empty or longer than 40 characters. Send a name of 1 to 40 characters.
400 bad_request icon is longer than 32 characters or has characters other than ASCII letters and digits. Send an icon name from the app's icon set, or an empty string to clear it.
400 bad_request color is not a #rrggbb hex color. Send a color such as #1d9bf0, or an empty string to clear it.
400 bad_request An entry in handles is not a valid X handle. Send @name, name or an x.com profile link.
403 forbidden The caller is not an admin. Call it with an admin account's session.
404 not_found No list with this ID belongs to the caller. Pick a list ID from List tracker lists.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.updateList(id, patch) src/lib/proxima/endpoints/tracker.ts

Delete a list

Admin JWT internal
DEL /tracker/lists/{list_id}

Deletes one of the caller's tracker lists.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat answers 404 once the list is gone.

Tracked accounts are not affected.

Path parameters

  • list_id string Required
    List ID.
    Example67744a28-e685-49cd-a56b-803b8e647080

Returns 200 OK · application/json

The web app does not read the response body.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. Call it with an admin account's session.
404 not_found No list with this ID belongs to the caller. Pick a list ID from List tracker lists.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.deleteList(id) src/lib/proxima/endpoints/tracker.ts

Search X posts

Admin JWT internal
GET /tracker/frontrun/search

Searches X through Frontrun, newest first.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

Accepts keywords, contract addresses and X operators such as from: or min_faves:. The backend relays Frontrun's envelope unchanged: check status before reading data. The app caches each page for 60 seconds.

Query parameters

  • q string Required
    Search query.
    Example$OTTER min_faves:50
  • page_size integer Optional
    Results per page. The app sends 20.
  • cursor string Optional
    nextCursor from the previous page.

Returns 200 OK · application/json

  • status boolean
    false when Frontrun reports a failure, with message.
  • message string
    Frontrun's message.
  • data object
    Search page.
    Child attributes 2
    • tweets array<object>
      Raw tweets with tweet_id, url, screen_name, text, created_at, engagement counts, user_info, media and entities.
    • nextCursor string | null
      Cursor for the next page, or null.

Errors

StatusCodeWhen and what to do
400 bad_request q is empty. Send a search query in q.
401 — Frontrun rejected the server's API key. Relayed with Frontrun's own body, without a Proxima code. Check the Frontrun key configured on the server.
403 forbidden The caller is not an admin. Call it with an admin account's session.
403 — Frontrun rejected the server's API key. Relayed with Frontrun's own body, without a Proxima code. Check the Frontrun key configured on the server.
422 upstream_failure The server has no Frontrun key, or the call to Frontrun failed in transit. Set FRONTRUN_API_KEY on the server, or retry later.
429 — Frontrun rate limit (60 requests per minute). Relayed with Frontrun's own body, without a Proxima code. Wait a minute before the next Frontrun call.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.frontrunSearch({ q, pageSize, cursor }) src/lib/proxima/endpoints/tracker.ts

Retrieve an X profile report

Admin JWT internal
GET /tracker/frontrun/profile/{handle}/{report}

Returns a Frontrun report on an X account: its profile, its smart followers, or the contract addresses it posted.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The data shape depends on report:

  • info: profile with twitterId, name, twitterUsername, bio, profilePhoto, followersCount, followingsCount and labels, or null.
  • smart-followers: { smartFollowers, totalCount }.
  • tweets-with-ca: { topUndeletedTweets, topDeletedTweets, undeletedCACount, deletedCACount, undeletedTweetCount, deletedTweetCount }, including tweets that were later deleted.

The app caches each report for 10 minutes so reopening a profile does not spend credits twice.

Path parameters

  • handle string Required
    X handle, without @.
    Exampleexamplecaller
  • report enum Required
    Report to fetch.
    Possible values infosmart-followerstweets-with-ca

Returns 200 OK · application/json

  • status boolean
    false when Frontrun reports a failure.
  • message string
    Frontrun's message.
  • data any
    Report payload; see above.

Errors

StatusCodeWhen and what to do
400 bad_request handle is not a valid X handle. Send @name, name or an x.com profile link.
403 forbidden The caller is not an admin. Call it with an admin account's session.
404 not_found report is not info, smart-followers or tweets-with-ca. Use info, smart-followers or tweets-with-ca.
422 upstream_failure The server has no Frontrun key, or the call to Frontrun failed in transit. Set FRONTRUN_API_KEY on the server, or retry later.
429 — Frontrun rate limit (60 requests per minute). Relayed with Frontrun's own body, without a Proxima code. Wait a minute before the next Frontrun call.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.frontrunProfile(handle, endpoint) src/lib/proxima/endpoints/tracker.ts

GET /tracker/frontrun/old-username/{handle}

Returns the X accounts that used this handle before renaming away from it.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

Path parameters

  • handle string Required
    X handle, without @.
    Exampleexamplecaller

Returns 200 OK · application/json

  • status boolean
    false when Frontrun reports a failure.
  • message string
    Frontrun's message.
  • data object
    Lookup result.
    Child attributes 2
    • found boolean
      Whether earlier owners were found.
    • profiles array<object>
      Earlier accounts. The app reads twitterUsername (or username, twitter), name and profilePhoto.

Errors

StatusCodeWhen and what to do
400 bad_request handle is not a valid X handle. Send @name, name or an x.com profile link.
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 upstream_failure The server has no Frontrun key, or the call to Frontrun failed in transit. Set FRONTRUN_API_KEY on the server, or retry later.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.frontrunOldUsername(handle) src/lib/proxima/endpoints/tracker.ts

Retrieve Frontrun credits

Admin JWT internal
GET /tracker/frontrun/credits

Returns the Frontrun credit balance of the tracker's API key.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

Parameters

No parameters.

Returns 200 OK · application/json

  • status boolean
    false when Frontrun reports a failure.
  • data object
    Credit balance.
    Child attributes 2
    • currentPoints number
      Credits left.
    • totalCredits string
      Total credits, as a numeric string.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 upstream_failure The server has no Frontrun key, or the call to Frontrun failed in transit. Set FRONTRUN_API_KEY on the server, or retry later.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.frontrunCredits() src/lib/proxima/endpoints/tracker.ts

Suggest token names for a tweet

Admin JWT internal
POST /tracker/suggest

Returns name and ticker picks for a tweet, to prefill a token deploy.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Picks are made once per tweet id and saved; a repeat returns the saved picks.

The web app asks for three picks per tweet, once the tweet card scrolls into view, and caches them for the session. The SDK returns the suggestions array.

Body parameters application/json

  • id string Optional
    Tweet ID.
  • text string Optional
    Tweet text.
  • handle string Optional
    Author handle.
  • followers integer | null Optional
    Author follower count.
  • media array<string> Optional
    Photo URLs.
  • posters array<string> Optional
    Video poster URLs.
  • avatar string | null Optional
    Author avatar URL.
  • quoted_handle string | null Optional
    Handle of the quoted tweet's author.
  • quoted_text string | null Optional
    Text of the quoted tweet.
  • quoted_media array<string> Optional
    Photo URLs of the quoted tweet.
  • reply_to string | null Optional
    Handle the tweet replies to.
  • cashtags array<string> Optional
    Cashtags in the text, without $.

Returns 200 OK · application/json

Returns a list of Suggestion objects.

Errors

StatusCodeWhen and what to do
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 unprocessable The examples the suggestions rely on cannot be loaded. Check the trench examples on the server (TRENCH_AI_DIR).
422 upstream_failure The server has no Gemini key. Set GEMINI_API_KEY on the server.
422 upstream_failure Gemini returned no usable suggestion for this tweet. Retry, or name the token by hand.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.suggest(tweet) src/lib/proxima/endpoints/tracker.ts

Analyze a tweet image

Admin JWT internal
POST /tracker/vision

Detects the subjects and legible texts in an image, with their positions.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Results are cached per image for an hour.

Send either url (an X media URL) or image (a data:image/...;base64, URL for an image only the browser holds, such as a captured video frame). The SDK picks the field from the source string. Boxes are in percent of the image, from 0 to 100. The app draws them over tweet images when detect vision is on.

Body parameters application/json

  • url string Optional
    X media URL. Send this or image.
  • image string Optional
    Image as a data: URL. Send this or url.

Returns 200 OK · application/json

  • subjects array<object>
    Detected subjects.
    Child attributes 2
    • label string
      What the subject is.
    • box object
      { x, y, width, height } in percent of the image.
  • texts array<object>
    Legible texts.
    Child attributes 4
    • text string
      Text as read.
    • name string
      Token name derived from the text.
    • symbol string
      Ticker derived from the text.
    • box object
      { x, y, width, height } in percent of the image.

Errors

StatusCodeWhen and what to do
400 bad_request The body has both url and image, or neither. Send exactly one of url and image.
400 bad_request url is not a valid URL. Send the full https URL of the image.
400 bad_request url is not an https image on pbs.twimg.com, abs.twimg.com or video.twimg.com. Send an X media URL, or the image itself in image.
400 bad_request image is not a base64 data: URL. Send image as data:image/<type>;base64,<data>.
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 unprocessable The URL or the data does not hold an image. Send an image.
422 unprocessable The image is larger than 8 MB. Send an image under 8 MB.
422 upstream_failure The X media host answered an error status for url. Check that the image still exists on X.
422 upstream_failure The server has no Gemini key. Set GEMINI_API_KEY on the server.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role, 403 read_only_token and 429 when rate limited.

Web client proxima.tracker.vision(source) src/lib/proxima/endpoints/tracker.ts

Search web images

Admin JWT internal
GET /tracker/images

Searches Google Images through Serper, to pick a deploy image.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

Returns Serper's payload as relayed by the backend. The app reads imageUrl, title, thumbnailUrl, imageWidth, imageHeight and source (or domain) from each image, and caches results per query for the session.

Query parameters

  • q string Required
    Search query.
    Examplesea otter meme

Returns 200 OK · application/json

  • images array<object>
    Image results.

Errors

StatusCodeWhen and what to do
400 bad_request q is empty or longer than 120 characters. Send a query of 1 to 120 characters.
403 forbidden The caller is not an admin. Call it with an admin account's session.
422 upstream_failure The server has no Serper key. Set SERPER_API_KEY on the server.
422 upstream_failure Serper answered an error status. Retry in a few minutes.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.images(query) src/lib/proxima/endpoints/tracker.ts

Retrieve a tweet

Admin JWT internal
GET /tracker/fx/{tweet_id}

Returns a public tweet's details from FxTwitter, used to walk reply threads and quote chains.

Token
Upgraded session token of an account with admin rights.
Read-only tokens
Allowed.
Retry
Safe to retry

The backend relays FxTwitter's status payload. The app reads id, text, url, author (screen_name, name, avatar_url, followers), media.all, created_timestamp (Unix seconds), replying_to, replying_to_status and quote. Requests run at most 4 at a time and results are cached for the session.

Path parameters

  • tweet_id string Required
    Tweet ID.
    Example1852200000000000001

Returns 200 OK · application/json

  • tweet object
    FxTwitter tweet object.

Errors

StatusCodeWhen and what to do
400 bad_request tweet_id is not 1 to 25 digits. Pass the numeric ID from the tweet URL.
403 forbidden The caller is not an admin. Call it with an admin account's session.
404 — The tweet was deleted or does not exist. Relayed from FxTwitter with its own body, without a Proxima code; the backend caches the miss for 10 minutes and the app caches it too.
422 upstream_failure FxTwitter could not be reached. Retry in a few minutes.

Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.

Web client proxima.tracker.fxTweet(id) src/lib/proxima/endpoints/tracker.ts