Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. externalId is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the externalId; resend with the same value. Live only: an app in paper trading mode gets 400 with paper_mode_unsupported.
Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.
Authorization
string
header
required
JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.
Body
application/json
venue
enum<string>
required
The venue to trade on. Singular by design — this endpoint never splits an order.
Available options:
kalshi,
polymarket,
limitless,
predict,
pred,
tiprun,
myriad,
hyperliquid,
novig,
prophetx,
betdex,
lighter
venueMarketOutcomeId
string
required
The outcome to trade. May be the outcome on another venue: it is resolved through matched-outcome links to the equivalent outcome on venue. Passing the id that already lives on venue is the unambiguous form.
Minimum string length: 1
side
enum<string>
required
Trade direction. sell closes an existing position on venue.
Available options:
buy,
sell
externalId
string
required
Idempotency key. Your own id for this trade — required, and unique within your app: two different users of the same app cannot share one. A repeat is rejected with 409 rather than trading twice, so it is safe to retry a request that timed out using the same value. A request rejected before its order was queued leaves the value free to reuse.
Required string length: 1 - 36
maxSpend
number
Buy only. Maximum all-in USD spend, inclusive of app fee.
Required range: x > 0
sellShares
number
Sell only. Number of contracts to sell.
Required range: x > 0
slipCapBps
number
Slippage cap in basis points. Defaults to 500 (5%) when omitted. On sells set this explicitly: sellShares bounds the shares sold, not the proceeds.
Required range: x >= 0
allowedSourceChainIds
integer[]
Restrict funding to these source chains. Omitted, the order may be funded from any chain the user holds, bridging in when the venue's own chain is short. Listing only the venue's chain (56 for predict.fun, 137 for Polymarket) makes the order fail with insufficient funding instead of bridging. Balances are still read on-chain: this narrows which of them may be spent, it never adds capacity.
Minimum array length: 1
Required range: x >= 1
chainBalances
object
Per-chain USD funding budgets, e.g. {"56": 50}. Caps refreshed wallet balances; never adds capacity. A chain-only budget is shared across its token buckets. Omitted chains cannot fund the order; an empty map allows no on-chain funding. Combines with allowedSourceChainIds: excluded chains cannot fund the order.
Show child attributes
appFeeBips
number
Per-trade app fee in basis points of routed notional, 0..10000. Replaces the app's configured rate for this order only. Honoured only when the request carries x-app-api-key; otherwise 400 app_fee_override_requires_api_key. Buy only.
Required range: 0 <= x <= 10000Must be a multiple of 1
appFeeBipsByVenue
object
Per-venue app fee in basis points, e.g. {"polymarket":20,"hyperliquid":10}. Keys are venue names; a rate applies to the legs filled on that venue and overrides appFeeBips there. The scalar appFeeBips still applies to venues the map omits. Honoured only when the request carries x-app-api-key; otherwise 400 app_fee_override_requires_api_key. Buy only.
Show child attributes
referrerFeeBipsByVenue
object
Per-venue referral fee in basis points, e.g. {"polymarket":20,"hyperliquid":10}. Keys are venue names; a rate applies to the legs filled on that venue and overrides referrerFeeBips there, which still applies to venues the map omits. referrerFeeBips is optional when this is sent; 0 = no referral on that venue, but at least one venue must end up with a positive rate. Needs referrer. Same rules as referrerFeeBips: x-app-api-key required, buy only.
Show child attributes
referrer
string
Referral: the EVM address that receives the referral fee. Requires referrerFeeBips or referrerFeeBipsByVenue. Honoured only when the request carries x-app-api-key; a JWT-only request that sends it is rejected with 400 referral_requires_api_key. Buy only.
Required string length: 42
referrerFeeBips
number
Referral fee in basis points of the routed notional, 1..10000. AGG takes no share of it. With referralPayer "user" it is reserved from maxSpend next to the app fee; with "app" the user pays nothing.
Required range: 1 <= x <= 10000Must be a multiple of 1
referralPayer
enum<string>
Who funds the referral. Default "user".
Available options:
user,
app
referralPayerAddress
string
Required when referralPayer is "app": the wallet that settles the payout. After the fill, a pendingSignatures entry appears with signerAddress set to this address and purpose "referral_payout"; answer it on POST /execution/fill/:quoteId/signatures. Read its type: on an EVM chain it is a transaction to broadcast (post the hash), on HyperCore an eip712 to sign (post the signature).
Required string length: 42
referralPayoutChainId
number
Optional, and only with referralPayer "app": the chain the referrer is paid on. Must carry USDC. On an EVM chain the payout is an ERC-20 transfer the partner's wallet broadcasts, needing USDC plus native gas there; on HyperCore (1337) it is a user-signed sendAsset from the partner's HyperCore spot balance — a signature, nothing to broadcast — and the referrer receives spot USDC on Hyperliquid. A first payout to a referrer with no Hyperliquid account costs the partner an extra 1 USDC that Hyperliquid charges to create it; later payouts to the same referrer cost nothing. Solana does not support app-paid payouts and is refused. Defaults to the trade's fee chain, or Polygon when that chain is not EVM. Sending it with a user-paid referral is rejected with 400 referral_invalid.
Required range: x >= 1Must be a multiple of 1
referralActivationSponsorAddress
string
Optional, and only with a user-paid referral (referralPayer "user" or absent): a wallet that pays Hyperliquid's one-time 1 USDC account-activation fee when the referrer has never received anything on HyperCore. Honoured on self-custody Hyperliquid buys only; ignored otherwise. Before the fill a pendingSignatures entry appears with signerAddress set to this address, purpose "hl_activation_sponsor" and optional: true — an eip712 sendAsset of 0.000001 USDC to the referrer. Sign it and post the signature on POST /execution/fill/:quoteId/signatures. After the fill it is posted just before the referral transfer, only if the referrer still has no HyperCore account. This wallet's HyperCore spot balance must hold at least 1.000001 USDC. Declining it is safe: the trade proceeds and the referral is attempted as usual. Must differ from referrer; rejected with referralPayer "app". The request reaches your signer through the user's client: sign only the exact transfer described here (see Fees → Securing the paying wallet's signer).
Required string length: 42
skipQuote
boolean
Skip the smart-route solver and send one order straight to venue. predict, hyperliquid, kalshi, novig and prophetx only; any other venue returns 400. Requires a read_writex-app-api-key (401 without a key, 403 with a read key). No bridging: the funds must already sit on the venue's own chain, and allowedSourceChainIds / chainBalances are ignored. A buy the stored balance cannot fund returns 400 quote_insufficient_balance before acceptance. Referral fields apply to buys as on a routed order; on a sell they return 400. You own the price and minimum checks — an order the venue refuses fails after acceptance and uses up its externalId. Kalshi and connected ProphetX/Novig API buys use fixed-price admission automatically; the venue decides available cash when accepting the order.
skipBalance
boolean
With skipQuote, skip the balance check and fund hold on a buy: nothing checks the balance and an underfunded order fails at the venue. Sells still check and hold the position. Without skipQuote, skip only the quote-time balance refresh: the route uses the last stored balances, and the fund hold and balance check still run, so a stale balance can fail the order after acceptance but never overspend. Requires a read_writex-app-api-key.
price
number
With skipQuote or a native API buy, the price limit, e.g. 0.52. Optional: omitted, the best available price at submission is used (best ask for a buy, best bid for a sell), and an empty side returns 400. A hyperliquid buy is sized as the whole contracts that fit maxSpend at this price plus slippage. Ignored on clearinghouse prophetx, which prices the order itself within slipCapBps.
Required range: 0 < x < 1
Response
200
orderId
string
required
The single order this call created.
externalId
string
required
Echoed back so a webhook or socket event can be tied to this response.
venue
enum<string>
required
The venue the order was placed on.
Available options:
kalshi,
polymarket,
limitless,
predict,
pred,
tiprun,
myriad,
hyperliquid,
novig,
prophetx,
betdex,
lighter
status
enum<string>
required
Always pending: the order is accepted and queued for execution, not yet filled. Poll GET /execution/orders or listen for order events for the terminal state.
Available options:
pending
quoteId
string
required
Server-minted quote backing this order. Useful for support, not required.
quotedPriceRaw
string | null
required
Quoted price, decimal string (e.g. "0.53"). null if the order row does not carry a quoted price — the order is still live; re-fetch it from GET /execution/orders rather than treating this as zero.
quotedCostRaw
string | null
required
Quoted cost, 6-decimal atomic USDC. null under the same conditions as quotedPriceRaw.
quotedSharesRaw
string | null
required
Quoted shares, 6-decimal atomic. null under the same conditions as quotedPriceRaw.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Agg.market — Prediction Market Aggregator","description":"White-label prediction market aggregator API: sign users in, quote the best price across venues, execute trades, and track them to a final status. Start with Quickstart: REST.","colors":{"primary":"#ED8200","light":"#FFA366","dark":"#C66F00"},"logo":{"light":"https://mintcdn.com/agg/SLxnoWBYT8Zyhg9W/assets/agg-dark.svg?fit=max\u0026auto=format\u0026n=SLxnoWBYT8Zyhg9W\u0026q=85\u0026s=f1b6e05f3e2529bc2c7698267234f5d1","dark":"https://mintcdn.com/agg/SLxnoWBYT8Zyhg9W/assets/agg-white.svg?fit=max\u0026auto=format\u0026n=SLxnoWBYT8Zyhg9W\u0026q=85\u0026s=4a896195354d17f32101e0ec90fb822c"},"favicon":"https://mintcdn.com/agg/OOif8Fd2iWonTlgU/assets/favicon.svg?fit=max\u0026auto=format\u0026n=OOif8Fd2iWonTlgU\u0026q=85\u0026s=6907ac01c9b9a95394f668f53099f108","background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://storybook.agg.market","label":"Storybook"}],"primary":{"type":"button","label":"Admin Dashboard","href":"https://admin.agg.market"}},"footer":{"socials":{"x":"https://x.com/Snag_Solutions","linkedin":"https://www.linkedin.com/company/snag-solutions"}},"banner":{"content":"AGG is currently in **alpha**. APIs, components, and docs may change.","dismissible":false},"metadata":{"timestamp":false},"markdown":{"instructions":["To integrate AGG, start with Quickstart: REST (https://docs.agg.market/quickstart/rest), then Order lifecycle \u0026 statuses (https://docs.agg.market/concepts/order-lifecycle).","Track every trade until it reaches a terminal status. Before retrying a failed or timed-out call, read Errors, retries \u0026 idempotency (https://docs.agg.market/concepts/errors).","The API reference is generated from https://docs.agg.market/openapi/openapi.json."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agg","hasAudioNarration":false,"actualSubdomain":"agg","customDomains":["docs.agg.market"],"gitSource":{"type":"github","owner":"snag-solutions","repo":"agg","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff4f795246eb87f3620b22","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Trading API","count":80},{"language":"default","tag":"Guides","count":73},{"language":"default","tag":"Trading","count":22},{"language":"default","tag":"Server API","count":21},{"language":"default","tag":"Users","count":13},{"language":"default","tag":"Core concepts","count":12},{"language":"default","tag":"Funding","count":12},{"language":"default","tag":"Market data","count":11},{"language":"default","tag":"Markets","count":10},{"language":"default","tag":"Partner Admin","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/trading/place-an-order-directly","slug":"/api-reference/trading/place-an-order-directly","pageMetadata":{"title":"Place an order directly","description":"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. `externalId` is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the `externalId`; resend with the same value. Live only: an app in paper trading mode gets 400 with `paper_mode_unsupported`.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/orders","href":"/api-reference/trading/place-an-order-directly","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. \", _jsx(_components.code, {\n children: \"externalId\"\n }), \" is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the \", _jsx(_components.code, {\n children: \"externalId\"\n }), \"; resend with the same value. Live only: an app in paper trading mode gets 400 with \", _jsx(_components.code, {\n children: \"paper_mode_unsupported\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`integration-guide`,children:`Integration guide`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Before you call:`}),` `,_jsx(_components.a,{href:`/concepts/funding`,children:`Fund an account and track withdrawals`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Workflow:`}),` `,_jsx(_components.a,{href:`/recipes/direct-order-execution`,children:`Place and track a direct order`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Next:`}),` `,_jsx(_components.a,{href:`/concepts/order-lifecycle`,children:`Track orders to a final state`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Place an order directly","description":"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. `externalId` is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the `externalId`; resend with the same value. Live only: an app in paper trading mode gets 400 with `paper_mode_unsupported`.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/orders","href":"/api-reference/trading/place-an-order-directly","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Integration guide","slug":"integration-guide","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. `externalId` is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the `externalId`; resend with the same value. Live only: an app in paper trading mode gets 400 with `paper_mode_unsupported`.","summary":"Place an order directly","tags":["Trading"],"operationId":"placeOrder","responses":{"200":"4227e84e-fc48-4477-96d9-1cff2a10b584","400":"ad70a40b-65b9-4447-bbbf-3df9564f69c6","401":"1a8b903c-fe8a-4865-aa98-9b9f1201544b","403":"6a9fc4ad-5e5c-4105-9d03-1d8d7df98232","404":"32b1f892-fd5e-4c80-9b93-d6ed2fb8bdc2","409":"56074637-6444-4c2f-974c-6a1825e922bc","429":"6eb9b1aa-8ce8-4fe1-b3fb-ce64cf1d5e28"},"requestBody":"b5a14825-cc45-4b2b-a34d-d1c266996844","security":["d1768d16-7e9f-4a45-b0c6-16f6196327d1"],"x-mint":{"content":"## Integration guide\n\n- **Before you call:** [Fund an account and track withdrawals](/concepts/funding).\n- **Workflow:** [Place and track a direct order](/recipes/direct-order-execution).\n- **Next:** [Track orders to a final state](/concepts/order-lifecycle)."},"method":"post","type":"path","servers":["3915078d-e73f-42da-9155-945be58f38f6"],"path":"/execution/orders","baseUrlOptions":["https://api.agg.market"],"title":"Place an order directly","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["venue","venueMarketOutcomeId","side","externalId"],"properties":{"venue":{"type":"string","description":"The venue to trade on. Singular by design — this endpoint never splits an order.","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"isRequired":true,"uniqueKey":"venue","typeLabel":"enum\u003cstring>"},"venueMarketOutcomeId":{"minLength":1,"description":"The outcome to trade. May be the outcome on another venue: it is resolved through matched-outcome links to the equivalent outcome on `venue`. Passing the id that already lives on `venue` is the unambiguous form.","type":"string","isRequired":true,"uniqueKey":"venueMarketOutcomeId","typeLabel":"string"},"side":{"description":"Trade direction. `sell` closes an existing position on `venue`.","type":"string","enum":["buy","sell"],"isRequired":true,"uniqueKey":"side","typeLabel":"enum\u003cstring>"},"externalId":{"minLength":1,"maxLength":36,"description":"Idempotency key. Your own id for this trade — required, and unique within your app: two different users of the same app cannot share one. A repeat is rejected with 409 rather than trading twice, so it is safe to retry a request that timed out using the same value. A request rejected before its order was queued leaves the value free to reuse.","type":"string","isRequired":true,"uniqueKey":"externalId","typeLabel":"string"},"maxSpend":{"exclusiveMinimum":true,"description":"Buy only. Maximum all-in USD spend, inclusive of app fee.","type":"number","minimum":0,"uniqueKey":"maxSpend","typeLabel":"number"},"sellShares":{"exclusiveMinimum":true,"description":"Sell only. Number of contracts to sell.","type":"number","minimum":0,"uniqueKey":"sellShares","typeLabel":"number"},"slipCapBps":{"minimum":0,"description":"Slippage cap in basis points. Defaults to 500 (5%) when omitted. On sells set this explicitly: `sellShares` bounds the shares sold, not the proceeds.","type":"number","uniqueKey":"slipCapBps","typeLabel":"number"},"allowedSourceChainIds":{"minItems":1,"description":"Restrict funding to these source chains. Omitted, the order may be funded from any chain the user holds, bridging in when the venue's own chain is short. Listing only the venue's chain (56 for predict.fun, 137 for Polymarket) makes the order fail with insufficient funding instead of bridging. Balances are still read on-chain: this narrows which of them may be spent, it never adds capacity.","type":"array","items":{"minimum":1,"type":"integer","uniqueKey":"allowedSourceChainIds.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"allowedSourceChainIds","typeLabel":"integer[]"},"chainBalances":{"description":"Per-chain USD funding budgets, e.g. `{\"56\": 50}`. Caps refreshed wallet balances; never adds capacity. A chain-only budget is shared across its token buckets. Omitted chains cannot fund the order; an empty map allows no on-chain funding. Combines with `allowedSourceChainIds`: excluded chains cannot fund the order.","type":"object","additionalProperties":{"minimum":0,"type":"number","uniqueKey":"chainBalances.additionalProperties","typeLabel":"number"},"uniqueKey":"chainBalances","typeLabel":"object"},"appFeeBips":{"minimum":0,"maximum":10000,"multipleOf":1,"description":"Per-trade app fee in basis points of routed notional, 0..10000. Replaces the app's configured rate for this order only. Honoured only when the request carries x-app-api-key; otherwise 400 app_fee_override_requires_api_key. Buy only.","type":"number","uniqueKey":"appFeeBips","typeLabel":"number"},"appFeeBipsByVenue":{"description":"Per-venue app fee in basis points, e.g. `{\"polymarket\":20,\"hyperliquid\":10}`. Keys are venue names; a rate applies to the legs filled on that venue and overrides `appFeeBips` there. The scalar `appFeeBips` still applies to venues the map omits. Honoured only when the request carries x-app-api-key; otherwise 400 app_fee_override_requires_api_key. Buy only.","type":"object","additionalProperties":{"minimum":0,"maximum":10000,"multipleOf":1,"type":"number","uniqueKey":"appFeeBipsByVenue.additionalProperties","typeLabel":"number"},"uniqueKey":"appFeeBipsByVenue","typeLabel":"object"},"referrerFeeBipsByVenue":{"description":"Per-venue referral fee in basis points, e.g. `{\"polymarket\":20,\"hyperliquid\":10}`. Keys are venue names; a rate applies to the legs filled on that venue and overrides `referrerFeeBips` there, which still applies to venues the map omits. `referrerFeeBips` is optional when this is sent; 0 = no referral on that venue, but at least one venue must end up with a positive rate. Needs `referrer`. Same rules as `referrerFeeBips`: x-app-api-key required, buy only.","type":"object","additionalProperties":{"minimum":0,"maximum":10000,"multipleOf":1,"type":"number","uniqueKey":"referrerFeeBipsByVenue.additionalProperties","typeLabel":"number"},"uniqueKey":"referrerFeeBipsByVenue","typeLabel":"object"},"referrer":{"minLength":42,"maxLength":42,"description":"Referral: the EVM address that receives the referral fee. Requires referrerFeeBips or referrerFeeBipsByVenue. Honoured only when the request carries x-app-api-key; a JWT-only request that sends it is rejected with 400 referral_requires_api_key. Buy only.","type":"string","uniqueKey":"referrer","typeLabel":"string"},"referrerFeeBips":{"minimum":1,"maximum":10000,"multipleOf":1,"description":"Referral fee in basis points of the routed notional, 1..10000. AGG takes no share of it. With referralPayer \"user\" it is reserved from maxSpend next to the app fee; with \"app\" the user pays nothing.","type":"number","uniqueKey":"referrerFeeBips","typeLabel":"number"},"referralPayer":{"description":"Who funds the referral. Default \"user\".","type":"string","enum":["user","app"],"uniqueKey":"referralPayer","typeLabel":"enum\u003cstring>"},"referralPayerAddress":{"minLength":42,"maxLength":42,"description":"Required when referralPayer is \"app\": the wallet that settles the payout. After the fill, a pendingSignatures entry appears with signerAddress set to this address and purpose \"referral_payout\"; answer it on POST /execution/fill/:quoteId/signatures. Read its type: on an EVM chain it is a `transaction` to broadcast (post the hash), on HyperCore an `eip712` to sign (post the signature).","type":"string","uniqueKey":"referralPayerAddress","typeLabel":"string"},"referralPayoutChainId":{"minimum":1,"multipleOf":1,"description":"Optional, and only with referralPayer \"app\": the chain the referrer is paid on. Must carry USDC. On an EVM chain the payout is an ERC-20 transfer the partner's wallet broadcasts, needing USDC plus native gas there; on HyperCore (1337) it is a user-signed sendAsset from the partner's HyperCore spot balance — a signature, nothing to broadcast — and the referrer receives spot USDC on Hyperliquid. A first payout to a referrer with no Hyperliquid account costs the partner an extra 1 USDC that Hyperliquid charges to create it; later payouts to the same referrer cost nothing. Solana does not support app-paid payouts and is refused. Defaults to the trade's fee chain, or Polygon when that chain is not EVM. Sending it with a user-paid referral is rejected with 400 referral_invalid.","type":"number","uniqueKey":"referralPayoutChainId","typeLabel":"number"},"referralActivationSponsorAddress":{"minLength":42,"maxLength":42,"description":"Optional, and only with a user-paid referral (referralPayer \"user\" or absent): a wallet that pays Hyperliquid's one-time 1 USDC account-activation fee when the referrer has never received anything on HyperCore. Honoured on self-custody Hyperliquid buys only; ignored otherwise. Before the fill a pendingSignatures entry appears with signerAddress set to this address, purpose \"hl_activation_sponsor\" and optional: true — an `eip712` sendAsset of 0.000001 USDC to the referrer. Sign it and post the signature on POST /execution/fill/:quoteId/signatures. After the fill it is posted just before the referral transfer, only if the referrer still has no HyperCore account. This wallet's HyperCore spot balance must hold at least 1.000001 USDC. Declining it is safe: the trade proceeds and the referral is attempted as usual. Must differ from referrer; rejected with referralPayer \"app\". The request reaches your signer through the user's client: sign only the exact transfer described here (see Fees → Securing the paying wallet's signer).","type":"string","uniqueKey":"referralActivationSponsorAddress","typeLabel":"string"},"skipQuote":{"description":"Skip the smart-route solver and send one order straight to `venue`. predict, hyperliquid, kalshi, novig and prophetx only; any other venue returns 400. Requires a `read_write` `x-app-api-key` (401 without a key, 403 with a `read` key). No bridging: the funds must already sit on the venue's own chain, and `allowedSourceChainIds` / `chainBalances` are ignored. A buy the stored balance cannot fund returns 400 `quote_insufficient_balance` before acceptance. Referral fields apply to buys as on a routed order; on a sell they return 400. You own the price and minimum checks — an order the venue refuses fails after acceptance and uses up its `externalId`. Kalshi and connected ProphetX/Novig API buys use fixed-price admission automatically; the venue decides available cash when accepting the order.","type":"boolean","uniqueKey":"skipQuote","typeLabel":"boolean"},"skipBalance":{"description":"With `skipQuote`, skip the balance check and fund hold on a buy: nothing checks the balance and an underfunded order fails at the venue. Sells still check and hold the position. Without `skipQuote`, skip only the quote-time balance refresh: the route uses the last stored balances, and the fund hold and balance check still run, so a stale balance can fail the order after acceptance but never overspend. Requires a `read_write` `x-app-api-key`.","type":"boolean","uniqueKey":"skipBalance","typeLabel":"boolean"},"price":{"exclusiveMinimum":true,"exclusiveMaximum":true,"description":"With `skipQuote` or a native API buy, the price limit, e.g. `0.52`. Optional: omitted, the best available price at submission is used (best ask for a buy, best bid for a sell), and an empty side returns 400. A hyperliquid buy is sized as the whole contracts that fit `maxSpend` at this price plus slippage. Ignored on clearinghouse prophetx, which prices the order itself within `slipCapBps`.","type":"number","minimum":0,"maximum":1,"uniqueKey":"price","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"example":{"venue":"polymarket","venueMarketOutcomeId":"cmf3q8z2m00a4mw0lr5t1k7yc","side":"buy","maxSpend":25,"externalId":"trade-2f9c61d4","slipCapBps":200},"examples":{"Example":{"title":"Example","value":{"venue":"polymarket","venueMarketOutcomeId":"cmf3q8z2m00a4mw0lr5t1k7yc","side":"buy","maxSpend":25,"externalId":"trade-2f9c61d4","slipCapBps":200}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4227e84e-fc48-4477-96d9-1cff2a10b584":{"description":"200","content":{"application/json":{"schema":{"type":"object","required":["orderId","externalId","venue","status","quoteId","quotedPriceRaw","quotedCostRaw","quotedSharesRaw"],"properties":{"orderId":{"description":"The single order this call created.","type":"string","isRequired":true,"uniqueKey":"orderId","typeLabel":"string"},"externalId":{"description":"Echoed back so a webhook or socket event can be tied to this response.","type":"string","isRequired":true,"uniqueKey":"externalId","typeLabel":"string"},"venue":{"type":"string","description":"The venue the order was placed on.","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"isRequired":true,"uniqueKey":"venue","typeLabel":"enum\u003cstring>"},"status":{"description":"Always `pending`: the order is accepted and queued for execution, not yet filled. Poll `GET /execution/orders` or listen for order events for the terminal state.","type":"string","enum":["pending"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"quoteId":{"description":"Server-minted quote backing this order. Useful for support, not required.","type":"string","isRequired":true,"uniqueKey":"quoteId","typeLabel":"string"},"quotedPriceRaw":{"oneOf":[{"description":"Quoted price, decimal string (e.g. \"0.53\"). `null` if the order row does not carry a quoted price — the order is still live; re-fetch it from `GET /execution/orders` rather than treating this as zero.","type":"string","isRequired":true,"uniqueKey":"quotedPriceRaw.oneOf.0","typeLabel":"string"},{"description":"Quoted price, decimal string (e.g. \"0.53\"). `null` if the order row does not carry a quoted price — the order is still live; re-fetch it from `GET /execution/orders` rather than treating this as zero.","type":"null","isRequired":true,"uniqueKey":"quotedPriceRaw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quotedPriceRaw","typeLabel":"string | null"},"quotedCostRaw":{"oneOf":[{"description":"Quoted cost, 6-decimal atomic USDC. `null` under the same conditions as `quotedPriceRaw`.","type":"string","isRequired":true,"uniqueKey":"quotedCostRaw.oneOf.0","typeLabel":"string"},{"description":"Quoted cost, 6-decimal atomic USDC. `null` under the same conditions as `quotedPriceRaw`.","type":"null","isRequired":true,"uniqueKey":"quotedCostRaw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quotedCostRaw","typeLabel":"string | null"},"quotedSharesRaw":{"oneOf":[{"description":"Quoted shares, 6-decimal atomic. `null` under the same conditions as `quotedPriceRaw`.","type":"string","isRequired":true,"uniqueKey":"quotedSharesRaw.oneOf.0","typeLabel":"string"},{"description":"Quoted shares, 6-decimal atomic. `null` under the same conditions as `quotedPriceRaw`.","type":"null","isRequired":true,"uniqueKey":"quotedSharesRaw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quotedSharesRaw","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"orderId":"cmf3r1a2b00c4mw0lq8y7e3uj","externalId":"trade-2f9c61d4","venue":"polymarket","status":"pending","quoteId":"k2r8v5n1x7c4m9t3b6q0w2za","quotedPriceRaw":"0.52","quotedCostRaw":"25000000","quotedSharesRaw":"48076923"},"examples":{"Example":{"title":"Example","value":{"orderId":"cmf3r1a2b00c4mw0lq8y7e3uj","externalId":"trade-2f9c61d4","venue":"polymarket","status":"pending","quoteId":"k2r8v5n1x7c4m9t3b6q0w2za","quotedPriceRaw":"0.52","quotedCostRaw":"25000000","quotedSharesRaw":"48076923"}}},"exampleType":"examples"}},"exampleType":"examples"},"ad70a40b-65b9-4447-bbbf-3df9564f69c6":{"description":"400","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","enum":["quote_not_found","quote_expired","quote_already_executed","quote_cancelled","quote_user_mismatch","quote_app_blocked","quote_unfillable","quote_min_order_size","quote_stale_status","quote_stale_price","quote_insufficient_balance","quote_market_inactive","quote_self_custody_unsupported_venue","quote_self_custody_app_fee","quote_self_custody_redeem_unsupported","quote_self_custody_limitless_foreign_profile","quote_self_custody_limitless_smart_wallet","quote_self_custody_tiprun_ambiguous_account","venue_not_executable","outcome_ambiguous","paper_mode_unsupported"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"quote_not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"1a8b903c-fe8a-4865-aa98-9b9f1201544b":{"description":"401","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6a9fc4ad-5e5c-4105-9d03-1d8d7df98232":{"description":"403","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","enum":["geo_blocked"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"geo_blocked"}}},"exampleType":"generated"}},"exampleType":"generated"},"32b1f892-fd5e-4c80-9b93-d6ed2fb8bdc2":{"description":"404","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"56074637-6444-4c2f-974c-6a1825e922bc":{"description":"409","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6eb9b1aa-8ce8-4fe1-b3fb-ce64cf1d5e28":{"description":"429","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"statusCode":{"type":"number","enum":[429],"uniqueKey":"oneOf.0.statusCode","typeLabel":"enum\u003cnumber>"},"code":{"type":"string","enum":["rate_limited"],"uniqueKey":"oneOf.0.code","typeLabel":"enum\u003cstring>"},"retryAfter":{"minimum":1,"description":"Retry delay in seconds.","type":"integer","uniqueKey":"oneOf.0.retryAfter","typeLabel":"integer"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["message","statusCode","code","venue","retryAfter"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"statusCode":{"type":"number","enum":[429],"isRequired":true,"uniqueKey":"oneOf.1.statusCode","typeLabel":"enum\u003cnumber>"},"code":{"type":"string","enum":["venue_rate_limited"],"isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"enum\u003cstring>"},"venue":{"type":"string","enum":["prophetx"],"isRequired":true,"uniqueKey":"oneOf.1.venue","typeLabel":"enum\u003cstring>"},"retryAfter":{"minimum":1,"maximum":60,"description":"Retry delay in seconds.","type":"integer","isRequired":true,"uniqueKey":"oneOf.1.retryAfter","typeLabel":"integer"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","statusCode":429,"code":"rate_limited","retryAfter":2}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d1768d16-7e9f-4a45-b0c6-16f6196327d1":{"appId":{"type":"apiKey","in":"header","name":"x-app-id","description":"Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.","scopes":[],"schemeName":"appId"},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"3915078d-e73f-42da-9155-945be58f38f6":{"url":"https://api.agg.market","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-app-id","description":"Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.","scopes":[],"schemeName":"appId"},"schema":{"title":"x-app-id","type":"string","description":"Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"appId","name":"x-app-id"},{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"appId \u0026 bearerAuth"}]},"originalFileLocation":"openapi/openapi.json"},"subdomain":"agg","siteName":"Agg.market — Prediction Market Aggregator","title":"Place an order directly - Agg.market — Prediction Market Aggregator","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T18:31:38.729Z","originalFileLocation":"api-reference/trading/place-an-order-directly.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. externalId is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the externalId; resend with the same value. Live only: an app in paper trading mode gets 400 with paper_mode_unsupported.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Place an order directly - Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head property=\"og:description\" content=\"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. externalId is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the externalId; resend with the same value. Live only: an app in paper trading mode gets 400 with paper_mode_unsupported.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agg.market/api-reference/trading/place-an-order-directly\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agg.mintlify.site/_mintlify/api/og/v2?division=Trading\u0026amp;title=Place+an+order+directly\u0026amp;description=Places+a+market+order+on+a+single+named+venue+without+a+prior+quote.+The+route+is+priced+and+funded+server-side+and+always+produces+exactly+one+order.+%60external\u0026amp;theme=e3d91c6fb16e65bc3c49f43b\u0026amp;signature=a2f161b78de792cf7186b13f84c8df88f0b0c03d892268d9c0a3dfbaa7561a4c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Place an order directly - Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. externalId is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the externalId; resend with the same value. Live only: an app in paper trading mode gets 400 with paper_mode_unsupported.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agg.mintlify.site/_mintlify/api/og/v2?division=Trading\u0026amp;title=Place+an+order+directly\u0026amp;description=Places+a+market+order+on+a+single+named+venue+without+a+prior+quote.+The+route+is+priced+and+funded+server-side+and+always+produces+exactly+one+order.+%60external\u0026amp;theme=e3d91c6fb16e65bc3c49f43b\u0026amp;signature=a2f161b78de792cf7186b13f84c8df88f0b0c03d892268d9c0a3dfbaa7561a4c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ED8200\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agg.market/api-reference/trading/place-an-order-directly\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/trading/place-an-order-directly.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agg.market/#organization\",\"name\":\"Agg.market — Prediction Market Aggregator\",\"url\":\"https://docs.agg.market\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agg/SLxnoWBYT8Zyhg9W/assets/agg-dark.svg?fit=max\u0026auto=format\u0026n=SLxnoWBYT8Zyhg9W\u0026q=85\u0026s=f1b6e05f3e2529bc2c7698267234f5d1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agg.market#website\",\"name\":\"Agg.market — Prediction Market Aggregator\",\"url\":\"https://docs.agg.market\",\"publisher\":{\"@id\":\"https://docs.agg.market/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly#webpage\",\"url\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly\",\"name\":\"Place an order directly\",\"description\":\"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. externalId is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the externalId; resend with the same value. Live only: an app in paper trading mode gets 400 with paper_mode_unsupported.\",\"dateModified\":\"2026-11-19T18:31:38.729Z\",\"isPartOf\":{\"@id\":\"https://docs.agg.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Trading\",\"item\":\"https://docs.agg.market/api-reference/trading/get-a-quote-smart-route\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Place an order directly\",\"item\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly#apireference\",\"headline\":\"Place an order directly\",\"name\":\"Place an order directly\",\"description\":\"Places a market order on a single named venue without a prior quote. The route is priced and funded server-side and always produces exactly one order. externalId is required and unique within your app — two different users of the same app cannot share one — so retrying a timed-out request with the same value returns 409 instead of trading twice. A request rejected before its order was queued (for example on a balance check) does not use up the externalId; resend with the same value. Live only: an app in paper trading mode gets 400 with paper_mode_unsupported.\",\"url\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agg.market/api-reference/trading/place-an-order-directly#webpage\"},\"dateModified\":\"2026-11-19T18:31:38.729Z\",\"publisher\":{\"@id\":\"https://docs.agg.market/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agg.market#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Agg.market — Prediction Market Aggregator\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Agg.market — Prediction Market Aggregator\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/trading/place-an-order-directly.md","siteName":"Agg.market — Prediction Market Aggregator","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/reference"}]},{"tab":"Trading API","groups":[{"group":"Authentication","pages":[{"title":"Start authentication","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/start","href":"/api-reference/authentication/start-authentication"},{"title":"Verify sign-in","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/verify","href":"/api-reference/authentication/verify-sign-in"},{"title":"Complete redirect sign-in","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/token/exchange","href":"/api-reference/authentication/complete-redirect-sign-in"},{"title":"Refresh access token","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/token/refresh","href":"/api-reference/authentication/refresh-access-token"},{"title":"Sign out","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/sign-out","href":"/api-reference/authentication/sign-out"},{"title":"Fetch Turnstile site key","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /bot-protection/site-key","href":"/api-reference/authentication/fetch-turnstile-site-key"},{"title":"Verify Turnstile token","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /bot-protection/verify","href":"/api-reference/authentication/verify-turnstile-token"}]},{"group":"Markets","pages":[{"title":"Get the first useful event view","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events/{id}/bootstrap","href":"/api-reference/markets/get-the-first-useful-event-view"},{"title":"Search events or markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /search","href":"/api-reference/markets/search-events-or-markets"},{"title":"List catalog changes","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /catalog/changes","href":"/api-reference/markets/list-catalog-changes"},{"title":"List venue events","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events","href":"/api-reference/markets/list-venue-events"},{"title":"Get Venue Event","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events/{id}","href":"/api-reference/markets/get-venue-event"},{"title":"List venue markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-markets","href":"/api-reference/markets/list-venue-markets"},{"title":"Look up venue market outcomes by external identifier","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-market-outcomes","href":"/api-reference/markets/look-up-venue-market-outcomes-by-external-identifier"},{"title":"List categories","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /categories","href":"/api-reference/markets/list-categories"},{"title":"Get the per-app UI config (disabled venues + categories)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /app/config","href":"/api-reference/markets/get-the-per-app-ui-config-disabled-venues-+-categories"},{"title":"List recurring crypto window markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /crypto/recurring-markets","href":"/api-reference/markets/list-recurring-crypto-window-markets"}]},{"group":"Market Data","pages":[{"title":"Get bounded outcome snapshots","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbooks/outcomes","href":"/api-reference/market-data/get-bounded-outcome-snapshots"},{"title":"Get live orderbooks for multiple markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbooks","href":"/api-reference/market-data/get-live-orderbooks-for-multiple-markets"},{"title":"Get live orderbook for a single outcome","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbook/outcome/{outcomeId}","href":"/api-reference/market-data/get-live-orderbook-for-a-single-outcome"},{"title":"Get live midpoints for multiple markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /midpoints","href":"/api-reference/market-data/get-live-midpoints-for-multiple-markets"},{"title":"Get versioned chart history references","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /charts/history/manifest","href":"/api-reference/market-data/get-versioned-chart-history-references"},{"title":"Get chart bars","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /charts/bars","href":"/api-reference/market-data/get-chart-bars"},{"title":"Get live crypto reference prices","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /crypto/reference-prices","href":"/api-reference/market-data/get-live-crypto-reference-prices"},{"title":"Get live sports scores","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /sports/live","href":"/api-reference/market-data/get-live-sports-scores"}]},{"group":"Trading","pages":[{"title":"Get a quote (smart route)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbook/{venueMarketOutcomeId}/route","href":"/api-reference/trading/get-a-quote-smart-route"},{"title":"Execute quote","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/fill","href":"/api-reference/trading/execute-quote"},{"title":"Submit signatures for a pending self-custody fill","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/fill/{quoteId}/signatures","href":"/api-reference/trading/submit-signatures-for-a-pending-self-custody-fill"},{"title":"Get execution status","description":"Returns quote-scoped execution progress, execution-plan step state, and terminal order leg results.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/status","href":"/api-reference/trading/get-execution-status"},{"title":"Place an order directly","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/orders","href":"/api-reference/trading/place-an-order-directly"},{"title":"Place limit order","description":"Places a venue-specific limit order. Managed orders reserve funds or shares. Self-custody buys can fund across supported chains using the existing client-signature flow; poll quoteId until the order is open or terminal. Fills are reconciled asynchronously.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/limit-orders","href":"/api-reference/trading/place-limit-order"},{"title":"Cancel an order","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/orders/cancel","href":"/api-reference/trading/cancel-an-order"},{"title":"Redeem winnings for resolved positions","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/redeem","href":"/api-reference/trading/redeem-winnings-for-resolved-positions"},{"title":"Get the per-venue blocked-country lists (ISO 3166-1 alpha-2)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /app/venue-geo-policy","href":"/api-reference/trading/get-the-per-venue-blocked-country-lists-iso-3166-1-alpha-2"}]},{"group":"Portfolio","pages":[{"title":"Get user orders","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/orders","href":"/api-reference/portfolio/get-user-orders"},{"title":"Get balances","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/balances","href":"/api-reference/portfolio/get-balances"},{"title":"Get user positions","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/positions","href":"/api-reference/portfolio/get-user-positions"},{"title":"Get user activity feed","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/activity","href":"/api-reference/portfolio/get-user-activity-feed"},{"title":"Trader leaderboard","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /leaderboard","href":"/api-reference/portfolio/trader-leaderboard"},{"title":"Trader leaderboard series","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /leaderboard/series","href":"/api-reference/portfolio/trader-leaderboard-series"}]},{"group":"Funding","pages":[{"title":"Get deposit addresses","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/deposit-addresses","href":"/api-reference/funding/get-deposit-addresses"},{"title":"Quote withdrawable amount","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdrawable/quote","href":"/api-reference/funding/quote-withdrawable-amount"},{"title":"Preview a withdrawal","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdraw/preview","href":"/api-reference/funding/preview-a-withdrawal"},{"title":"Withdraw funds","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdraw","href":"/api-reference/funding/withdraw-funds"},{"title":"Get withdrawal status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/withdrawals/{withdrawalId}","href":"/api-reference/funding/get-withdrawal-status"},{"title":"List managed balance refill policies","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/balance-refill-policies","href":"/api-reference/funding/list-managed-balance-refill-policies"},{"title":"Create a managed balance refill policy","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/balance-refill-policies","href":"/api-reference/funding/create-a-managed-balance-refill-policy"},{"title":"Update or pause a managed balance refill policy","deprecated":null,"version":null,"openapi":"/openapi/openapi.json patch /execution/balance-refill-policies/{policyId}","href":"/api-reference/funding/update-or-pause-a-managed-balance-refill-policy"},{"title":"List recent managed balance refill attempts","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/balance-refill-policies/{policyId}/attempts","href":"/api-reference/funding/list-recent-managed-balance-refill-attempts"},{"title":"Get crypto purchase quotes","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /ramp/quotes","href":"/api-reference/funding/get-crypto-purchase-quotes"},{"title":"Create a ramp widget session for checkout","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /ramp/session","href":"/api-reference/funding/create-a-ramp-widget-session-for-checkout"},{"title":"Submit signatures for a pending self-custody withdrawal","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdrawals/{withdrawalId}/signatures","href":"/api-reference/funding/submit-signatures-for-a-pending-self-custody-withdrawal"}]},{"group":"Users","pages":[{"title":"Get current user","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me","href":"/api-reference/users/get-current-user"},{"title":"Update username","deprecated":null,"version":null,"openapi":"/openapi/openapi.json patch /users/me","href":"/api-reference/users/update-username"},{"title":"Link partner external user ID (HMAC-verified)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/external-id","href":"/api-reference/users/link-partner-external-user-id-hmac-verified"},{"title":"Get avatar upload URL","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/avatar","href":"/api-reference/users/get-avatar-upload-url"},{"title":"Disconnect auth provider","deprecated":null,"version":null,"openapi":"/openapi/openapi.json delete /users/me/accounts/{provider}","href":"/api-reference/users/disconnect-auth-provider"},{"title":"Start account linking","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/link-account/start","href":"/api-reference/users/start-account-linking"},{"title":"Confirm account linking","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/link-account/confirm","href":"/api-reference/users/confirm-account-linking"},{"title":"Get shared KYC status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /kyc/status","href":"/api-reference/users/get-shared-kyc-status"},{"title":"Initiate KYC","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /kyc/{venue}","href":"/api-reference/users/initiate-kyc"},{"title":"Upsert a venue API key","deprecated":null,"version":null,"openapi":"/openapi/openapi.json put /venue-keys","href":"/api-reference/users/upsert-a-venue-api-key"},{"title":"List venue keys","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-keys","href":"/api-reference/users/list-venue-keys"},{"title":"Delete a venue key","deprecated":null,"version":null,"openapi":"/openapi/openapi.json delete /venue-keys/{venue}","href":"/api-reference/users/delete-a-venue-key"},{"title":"Get venue key connection status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-keys/{venue}/status","href":"/api-reference/users/get-venue-key-connection-status"}]},{"group":"Hosted Venue Accounts","pages":[{"title":"Get hosted venue deposit address","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}/deposit-address","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-deposit-address"},{"title":"Withdraw hosted venue funds","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/venue-accounts/{venue}/withdrawals","href":"/api-reference/hosted-venue-accounts/withdraw-hosted-venue-funds"},{"title":"Get hosted venue withdrawal","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}/withdrawals/{withdrawalId}","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-withdrawal"},{"title":"Get hosted venue account activity","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}/activity","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-account-activity"},{"title":"Get hosted venue account","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-account"},{"title":"Provision hosted venue account","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/venue-accounts/{venue}","href":"/api-reference/hosted-venue-accounts/provision-hosted-venue-account"}]},{"group":"News","pages":[{"title":"Get news articles for markets with market impact summaries","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /news-feed/market-news","href":"/api-reference/news/get-news-articles-for-markets-with-market-impact-summaries"},{"title":"Article-centric news feed for a category - latest articles with linked markets and live prices","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /news-feed/{category}","href":"/api-reference/news/article-centric-news-feed-for-a-category--latest-articles-with-linked-markets-and-live-prices"},{"title":"Market-centric news feed - markets grouped with their news timeline","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /news-feed/{category}/markets","href":"/api-reference/news/market-centric-news-feed--markets-grouped-with-their-news-timeline"},{"title":"List available news feeds with IDs and item counts","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /news-feed","href":"/api-reference/news/list-available-news-feeds-with-ids-and-item-counts"}]},{"group":"Correlated Markets","pages":[{"title":"Get correlated market signals for a market","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /correlated-markets/{venueMarketId}","href":"/api-reference/correlated-markets/get-correlated-market-signals-for-a-market"},{"title":"Find correlated markets by semantic similarity","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /correlated-markets/query","href":"/api-reference/correlated-markets/find-correlated-markets-by-semantic-similarity"},{"title":"Find events connected via shared market signals","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /correlated-markets/connections/{venueMarketId}","href":"/api-reference/correlated-markets/find-events-connected-via-shared-market-signals"},{"title":"Get ripple effect of a market resolving (by market ID)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /correlated-markets/cascade/{venueMarketId}","href":"/api-reference/correlated-markets/get-ripple-effect-of-a-market-resolving-by-market-id"},{"title":"Resolve a market by venue ID, slug, or text and return cascade","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /correlated-markets/resolve","href":"/api-reference/correlated-markets/resolve-a-market-by-venue-id-slug-or-text-and-return-cascade"}]}]},{"tab":"Server API","pages":[{"title":"Server API","href":"/api-reference/webhooks/rotate-webhook-signing-secret"}]},{"tab":"WebSocket API","pages":[{"title":"WebSocket API","href":"/api-reference/websockets/orderbook"}]}]},"basePath":"","title":"Place an order directly - Agg.market — Prediction Market Aggregator","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js"]}