Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

marketTicker

Returns the ticker for one perp instrument: last, mark, and oracle price, open interest, the current funding rate and its bounds, and 24-hour change and volume. Use it to fill a market header on first load, then keep it live with the ticker stream.

POST/infotype marketTicker

Fill a perp market header on first load: last, mark, oracle, funding, 24h change and volume.

Live stream
wsticker
Not this?
Note
Perp markets only.
Request body
instrumentIdintegerrequired

Numeric instrument id from `perpMeta` (`index`), sent as a JSON number.

typestringrequired

Must be `marketTicker`.

"marketTicker"
Request example
curl -X POST https://rpc.txflow-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -H "x-api-version: 2026-08-16" \
  -d '{
  "type": "marketTicker",
  "instrumentId": 1
}'
Try it
POST https://rpc.txflow-testnet.xyz/info
Response 200
codeinteger

`0` on success.

dataobject
blockTimeinteger

Block time of this snapshot, Unix ms.

change24hstring

`lastPrice` minus `prevDayPx`.

change24hPctstring

24h change in percent.

coinstring

Base name.

dayNtlVlmstring

24h notional volume in USDC.

fundingRatestring

Funding rate for the current interval, in percent (`0.01` means 0.01%).

instrumentIdinteger
lastPricestring

Last traded price.

markPxstring

Mark price.

nextFundingTimeinteger

Next funding settlement, Unix ms.

openIntereststring

Open interest in base units.

oraclePxstring

Oracle price.

prevDayPxstring

Price 24 hours ago.

rateCapstring

Upper bound of one funding settlement, in percent.

rateFloorstring

Lower bound of one funding settlement, in percent.

settlementIntervalMsinteger

Funding settlement interval in ms.

successboolean

`false` on error, with `code` set and the text in `message` instead of `data`.

Response example
{
  "success": true,
  "code": 0,
  "data": {
    "coin": "BTC",
    "instrumentId": 1,
    "lastPrice": "83387.4",
    "markPx": "83388.4",
    "oraclePx": "83420.1",
    "openInterest": "776.5054",
    "fundingRate": "0.00125000",
    "nextFundingTime": 1792576800000,
    "blockTime": 1792575637530,
    "dayNtlVlm": "22527876.25983",
    "prevDayPx": "81309.9",
    "change24h": "2077.5",
    "change24hPct": "2.56",
    "settlementIntervalMs": 3600000,
    "rateCap": "0.20000000",
    "rateFloor": "-0.20000000"
  }
}

instrumentId is the numeric index from perpMeta, sent as a JSON number.

fundingRate, rateCap, and rateFloor are percent per settlement interval: 0.00125 means 0.00125% every settlementIntervalMs. See Funding.