Get per-symbol asset reference data
GET/api/v1/assets/:symbol
Returns broker-agnostic reference data for a symbol, including margin requirements (maintenance, long, and short, expressed as a percent of market value) and the marginable, shortable, easy-to-borrow, and fractionable flags. Reads through to the caller's connected broker; UTM does not cache asset records.
Requires a connected broker that supports asset lookup. Alpaca does; TradeStation's Brokerage API has no per-symbol margin endpoint, so an account on a broker without this capability returns 400. When the caller omits accountId, the first connected account whose broker supports asset lookup is used.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 502
Asset reference data
Invalid symbol, or the resolved broker does not support asset lookup (code ASSET_LOOKUP_NOT_SUPPORTED), or the caller has no capable account (code NO_ASSET_LOOKUP_ACCOUNT).
Authentication required
Token is missing the trading:read scope
No asset found for the symbol (code ASSET_NOT_FOUND), or the account was not found.
Broker missing or invalid credentials
Broker request failed