Get a real-time price to trade against

curl --request GET \
  --url https://partners-api.sandbox.securitize.io/stocks/v1/stocks/realtime-price \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://partners-api.sandbox.securitize.io/stocks/v1/stocks/realtime-price', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://partners-api.sandbox.securitize.io/stocks/v1/stocks/realtime-price"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "symbol": "AAPL/USD",
  "mid": "231.235000000000000000",
  "bestBid": "231.220000000000000000",
  "bestAsk": "231.250000000000000000",
  "lastPrice": "231.240000000000000000",
  "lastSize": 100,
  "bidSize": 300,
  "askSize": 200,
  "marketIdentificationCode": "XNAS",
  "bidMarketIdentificationCode": "XNAS",
  "askMarketIdentificationCode": "ARCX",
  "lastMarketIdentificationCode": "XNAS",
  "bidTime": "2026-10-16T14:17:40.118Z",
  "askTime": "2026-10-16T14:17:40.118Z",
  "marketStatus": "OPEN",
  "reason": null,
  "validFrom": "2026-10-16T14:17:40.118Z",
  "validUntil": "2026-10-16T14:17:42.118Z",
  "staleness": 0,
  "signedPrice": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzeW1ib2wiOiJBQVBML1VTRCJ9.c2lnbmF0dXJl"
}

{
  "statusCode": 400,
  "message": [
    "amount must match /^\\d+$/ regular expression"
  ],
  "error": "Bad Request"
}

{
  "message": "No API key found in request"
}

{
  "statusCode": 403,
  "message": "UNAUTHORIZED_INVESTOR",
  "error": "Forbidden"
}

{
  "statusCode": 404,
  "message": "SYMBOL_NOT_FOUND",
  "error": "Not Found"
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}

Prices

Get a real-time price to trade against

The real-time price for one investor, with the signedPrice an order needs. Call it for the order ticket and the confirmation screen, on a fixed cadence while the ticket is open rather than on every keystroke.

Real-time data is entitled per investor: each call names an eligible investor, counts against that investor’s limit (one a second, sixty an hour) and is recorded against them. The investor must be verified with a verified suitability, and, in the European Economic Area, a passed DLT test; Securitize checks this on every call.

Two expiries with two jobs: validUntil is how long the quote is current, about 2 seconds, so refresh what you show by then. signedPrice is what the order is checked against: it expires about 20 seconds after it is issued, and the order is priced at the quote it signed. Prepare the order before then, or fetch a new price.

GET

stocks

realtime-price

Get a real-time price to trade against

curl --request GET \
  --url https://partners-api.sandbox.securitize.io/stocks/v1/stocks/realtime-price \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://partners-api.sandbox.securitize.io/stocks/v1/stocks/realtime-price', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://partners-api.sandbox.securitize.io/stocks/v1/stocks/realtime-price"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "symbol": "AAPL/USD",
  "mid": "231.235000000000000000",
  "bestBid": "231.220000000000000000",
  "bestAsk": "231.250000000000000000",
  "lastPrice": "231.240000000000000000",
  "lastSize": 100,
  "bidSize": 300,
  "askSize": 200,
  "marketIdentificationCode": "XNAS",
  "bidMarketIdentificationCode": "XNAS",
  "askMarketIdentificationCode": "ARCX",
  "lastMarketIdentificationCode": "XNAS",
  "bidTime": "2026-10-16T14:17:40.118Z",
  "askTime": "2026-10-16T14:17:40.118Z",
  "marketStatus": "OPEN",
  "reason": null,
  "validFrom": "2026-10-16T14:17:40.118Z",
  "validUntil": "2026-10-16T14:17:42.118Z",
  "staleness": 0,
  "signedPrice": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzeW1ib2wiOiJBQVBML1VTRCJ9.c2lnbmF0dXJl"
}

{
  "statusCode": 400,
  "message": [
    "amount must match /^\\d+$/ regular expression"
  ],
  "error": "Bad Request"
}

{
  "message": "No API key found in request"
}

{
  "statusCode": 403,
  "message": "UNAUTHORIZED_INVESTOR",
  "error": "Forbidden"
}

{
  "statusCode": 404,
  "message": "SYMBOL_NOT_FOUND",
  "error": "Not Found"
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}

Authorizations

x-api-key

string

header

required

Your API key, issued by Securitize. Send it in the x-api-key header on every request. The key identifies your partner account; investorId names the investor each call concerns.

Query Parameters

investorId

string

required

Securitize's id for the investor, as the SecId API's create returned it.

symbol

string

required

The stock's ticker, as your Securitize contact lists it. AAPL, AAPL/USD and AAPL/USDC all mean the same asset; the answer always names it AAPL/USD.

side

enum<string>

required

on-ramp to buy the stock with USDC, off-ramp to sell it for USDC. on-ramp buys the stock with USDC; off-ramp sells it for USDC.

Available options:

on-ramp,

off-ramp

amount

string

required

The amount the investor is about to trade, in raw base units as a string of digits — USDC on a buy, the stock token on a sell.

Pattern: ^\d+$

Response

The real-time price and its signed form.

symbol

string

required

The asset, always as <ticker>/USD.

mid

string

required

Midpoint of bestBid and bestAsk, as a decimal string.

bestBid

string

required

Consolidated best bid, as a decimal string.

bestAsk

string

required

Consolidated best offer, as a decimal string.

lastPrice

string

required

Last sale, as a decimal string.

marketStatus

string

required

OPEN, CLOSED or UNAVAILABLE. Only UNAVAILABLE blocks a trade; CLOSED is pre-market or post-market trading. Treat the list as open.

validFrom

string<date-time>

required

When the quote was observed.

validUntil

string<date-time>

required

How long the quote is current; refresh what you show by then. About 2 seconds after validFrom on a real-time quote. The order's own expiry is signedPrice's.

staleness

integer

required

How old the quote is, in seconds.

signedPrice

string

required

The price in signed form. Pass it unchanged on the order, so the order is priced exactly as the investor saw it. It expires about 20 seconds after it is issued.

lastSize

integer

Shares in the last sale.

bidSize

integer

Shares displayed at the bid.

askSize

integer

Shares displayed at the offer.

marketIdentificationCode

string

Venue MIC for the quote.

bidMarketIdentificationCode

string

Venue MIC of the best bid. Bid, offer and last can come from different venues; attribute each one.

askMarketIdentificationCode

string

Venue MIC of the best offer.

lastMarketIdentificationCode

string

Venue MIC of the last sale.

bidTime

string<date-time>

askTime

string<date-time>

reason

string | null

Why the market is not open: PRE_MARKET, POST_MARKET, FIVE_PERCENT_DEVIATION or TEN_PERCENT_DEVIATION. null when open.

Get started

Guides

Concepts

Help

API reference

Get a real-time price to trade against

Authorizations

Query Parameters

Response