How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Clear Street

Clear Street Positions API

The Positions API from Clear Street — 6 operation(s) for positions.

Documentation Provider Profile APIs.io OpenAPI GitHub

Clear Street Positions API is one of 23 APIs that Clear Street publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Positions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and a changelog.

This API exposes 8 operations across 6 paths, and defines 30 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 5 base URLs: https://api.clearstreet.io/studio/v2, https://sandbox-api.clearstreet.io/studio/v2, https://api.clearstreet.com, https://api-dev.clearstreet.com, http://localhost:5001.

8 operations 6 paths 30 schemas 3 DELETE4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.clearstreet.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Clear Street Positions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth).

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 3 DELETE, 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Positions 8
GET
/accounts/{account_id}/positions/{symbol}
Get position
getPosition 2 params → 200default
GET
/accounts/{account_id}/positions
List positions
listPositions 3 params → 200default
GET
/v1/accounts/{account_id}/positions
Get Positions
get_positions 6 params → 200403500
DELETE
/v1/accounts/{account_id}/positions
Close Positions
close_positions 1 param body → 200400403500
GET
/v1/accounts/{account_id}/positions/instructions
Get Position Instructions
get_position_instructions 2 params → 200400403404503
POST
/v1/accounts/{account_id}/positions/instructions
Submit Position Instructions
submit_position_instructions 1 param body → 200207400403404409500503
DELETE
/v1/accounts/{account_id}/positions/instructions/{instruction_id}
Cancel Position Instruction
cancel_position_instruction 2 params → 200403404409503
DELETE
/v1/accounts/{account_id}/positions/{instrument_id}
Close Position
close_position 2 params body → 200400403500

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are Order (32 properties), Position_2 (19 properties), PositionInstruction (12 properties), ResponseMetadata (6 properties). Each schema is shown below with its type and property counts.

Side
string
Side of an order
PositionInstructionStatus
string
Lifecycle status of a position instruction. - SENT: accepted and submitted to the clearing venue. - ACCEPTED: terminal — accepted by the clearing venue. - REJE…
InstrumentIdOrSymbol
string
Instrument identifier: either an instrument UUID or a symbol (symbol for equities, OSI for options). Non-UUID inputs are resolved server-side.
PositionType
string
Position type classification
Quantity
string
String representation of quantity.
ErrorDetails
array
Symbol
string
TimeInForce
string
Time in force
SecurityType
string
Security type
PositionInstructionType
string
The action to take against an options position.
ResponseMetadata
object
Metadata for the response. This will always contain a request ID which can be used to identify the request to Clear Street for tracing, and optionally may incl…
6 properties 1 required
OrderStatus
string
Order status
PositionInstructionSubmissionRequest
object
A position instruction to submit. Use DELETE /accounts/{accountid}/positions/instructions/{instructionid} to cancel an outstanding instruction.
4 properties 3 required
PositionInstruction
object
A position instruction and its current lifecycle state.
12 properties 8 required
TrailingOffsetType
string
Trailing offset type for trailing stop orders.
AccountNumber
string
Account number for the account.
PositionList
array
ApiError
object
A direct mapping of tonic::Status, for use in HTTP responses.
3 properties 2 required
QueueState
string
Parent order queue or hold state.
AccountId
string
Account ID for the account.
OrderType
string
Order type
Position
object
5 properties 5 required
Position_2
object
Represents a holding of a particular instrument in an account
19 properties 8 required
PositionInstructionList
array
ClosePositionRequest
object
1 property
OrderList
array
i64
integer
Order
object
A trading order with its current state and execution details. This is the unified API representation of an order across its lifecycle, combining data from exec…
32 properties 13 required
ProblemDetails
object
A Problem Details object (RFC 9457)
5 properties
BaseResponse
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

clear-street-positions-api-openapi.yml Raw ↑

Other APIs Clear Street publishes across the network.

Clear Street MCP Server
AE Profile APIs.io
Clear Street API (Trades and Uploads)
AE Profile APIs.io
Clear Street Accounts API
AE Profile APIs.io
Clear Street API version API
AE Profile APIs.io
Clear Street Calendar API
AE Profile APIs.io
Clear Street Entities API
AE Profile APIs.io
Clear Street Holdings API
AE Profile APIs.io
Clear Street Instrument Data API
AE Profile APIs.io
Clear Street Instruments API
AE Profile APIs.io
Clear Street Inventories API
AE Profile APIs.io
Clear Street Locates API
AE Profile APIs.io
Clear Street Margin API
AE Profile APIs.io
#Positions
← Back to C APIs
API Details
ID
clear-street:clear-street-positions-api
Base URL
https://api.clearstreet.com
Docs
https://docs.clearstreet.com/
Provider
Clear Street
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=clear-street-positions-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/clear-street-positions-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Clear Street Positions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.