Markets

The unified market token index - launchpad tokens and RH-4663 equities behind one browsable, server-owned, indexed surface (distinct from the live-proxy Launchpad/Market catalogs above). Public, unauthenticated market data; moves no funds.

Browse the unified market token index (launchpad + equity) - read-only, no auth

Query Parameters

kind?string

Default"launchpad"

Value in"launchpad" | "equity"

sort?string

Default"volume24h"

Value in"volume24h" | "mcap" | "age"

search?string

Case-insensitive substring match on name or symbol; an exact symbol match sorts first.

cursor?|

Opaque pagination cursor from the previous page's pageInfo.nextCursor.

limit?integer

Default20

Range1 <= value <= 100

Response Body

`application/json`

curl -X GET "https://api.app.botanary.xyz/markets/tokens"

{
  "tokens": [
    {
      "id": "equity:AAPL",
      "kind": "launchpad",
      "name": "string",
      "symbol": "string",
      "chain": "string",
      "chainId": 0,
      "tokenAddress": "string",
      "imageUrl": "string",
      "graduationStatus": "sentient",
      "category": "string",
      "priceUsd": 0,
      "priceChange24hPct": 0,
      "fdvUsd": 0,
      "volume24hUsd": 0,
      "liquidityUsd": 0,
      "holderCount": 0,
      "createdAt": "2019-08-24T14:15:22Z",
      "sparkline": [
        0
      ]
    }
  ],
  "nextCursor": "string",
  "total": 0
}

Price history for one market index token, for the detail chart - no auth

Path Parameters

id*string

A market index id, e.g. 'launchpad:base:0x...' or 'equity:AAPL'.

Query Parameters

range?string

Chart range for a price-history pull. An unrecognized value normalizes to 1M.

Default"1M"

Value in"1D" | "1W" | "1M" | "1Y" | "ALL"

Response Body

`application/json`

curl -X GET "https://api.app.botanary.xyz/markets/tokens/string/history"

{
  "symbol": "AAPL",
  "token": "0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825",
  "range": "1D",
  "asOf": "2019-08-24T14:15:22Z",
  "points": [
    {
      "t": 1752882000000,
      "price": 202.5
    }
  ]
}

One market index token by id - read-only, no auth

Path Parameters

id*string

A market index id, e.g. 'launchpad:base:0x...' or 'equity:AAPL'.

Response Body

`application/json`

curl -X GET "https://api.app.botanary.xyz/markets/tokens/string"

{
  "id": "equity:AAPL",
  "kind": "launchpad",
  "name": "string",
  "symbol": "string",
  "chain": "string",
  "chainId": 0,
  "tokenAddress": "string",
  "imageUrl": "string",
  "graduationStatus": "sentient",
  "category": "string",
  "priceUsd": 0,
  "priceChange24hPct": 0,
  "fdvUsd": 0,
  "volume24hUsd": 0,
  "liquidityUsd": 0,
  "holderCount": 0,
  "createdAt": "2019-08-24T14:15:22Z",
  "sparkline": [
    0
  ]
}

{
  "error": {
    "code": "out_of_scope",
    "message": "This action exceeds the per-action cap.",
    "declineReason": "cap_exceeded",
    "details": {},
    "requestId": "string"
  }
}

Subscription-scoped SSE price stream for the market index - read-only, no auth

Query Parameters

ids?string

Comma-separated market index ids to subscribe to, e.g. 'equity:AAPL,launchpad:base:0x...'.

Response Body

`text/event-stream`

curl -X GET "https://api.app.botanary.xyz/markets/stream"

{
  "id": "equity:AAPL",
  "priceUsd": 0,
  "priceChange24hPct": 0,
  "sparkline": [
    0
  ],
  "asOf": "2019-08-24T14:15:22Z"
}

200application/json

200application/json

200application/json

404application/json

200text/event-stream

`application/json`

`application/json`

`application/json`

`application/json`

`text/event-stream`