> For the complete documentation index, see [llms.txt](https://docs.intents.aurora.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intents.aurora.dev/api-reference/intents-connect-api-reference/request-an-execution.md). # Request an execution {% hint style="warning" %} **Pre-release** — The Intents Connect API is currently in development. If you're interested in early access, get in touch with the team. {% endhint %} ## Create a quote-backed execution > Creates or dry-runs a quote-backed execution. In non-dry mode the response includes the MPC intent payload that the frontend must sign. The destination type selects the step shape - EVM destinations send ExecutionStepEVM objects, Solana destinations (type=solana) send ExecutionStepSolana objects under the same steps key. Bridge-in requests execute steps on the destination chain after the 1click deposit succeeds. Out-operation requests execute steps on the origin chain and transfer the resulting tokens to the 1click deposit address. Solana supports bridge-in and out-operation, plus a gasless SPL model where a relayer pays the network fee in the destination token. For Stellar origins the response includes quote.depositMemo and the deposit transfer must include that memo or the bridge will not settle. ```json {"openapi":"3.0.3","info":{"title":"Intents Connect API","version":"1.0"},"servers":[{"url":"https://intents-connect-alpha-api.aurora.dev"}],"paths":{"/api/v1/executions/{wallet}":{"post":{"description":"Creates or dry-runs a quote-backed execution. In non-dry mode the response includes the MPC intent payload that the frontend must sign. The destination type selects the step shape - EVM destinations send ExecutionStepEVM objects, Solana destinations (type=solana) send ExecutionStepSolana objects under the same steps key. Bridge-in requests execute steps on the destination chain after the 1click deposit succeeds. Out-operation requests execute steps on the origin chain and transfer the resulting tokens to the 1click deposit address. Solana supports bridge-in and out-operation, plus a gasless SPL model where a relayer pays the network fee in the destination token. For Stellar origins the response includes quote.depositMemo and the deposit transfer must include that memo or the bridge will not settle.","parameters":[{"description":"Origin wallet identifier. Supports EVM addresses, NEAR accounts, NEAR implicit accounts, Solana base58 public keys, Stellar G-addresses, TON user-friendly addresses (TON requires body.publicKey), and Tron base58 (T...) addresses.","in":"path","name":"wallet","required":true,"schema":{"type":"string"}},{"description":"API key generated at https://studio.aurora.dev","in":"header","name":"x-api-key","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.createExecutionRequestDoc"}}},"description":"Execution request. For type=solana, each step is an executionStepSolanaDoc under the same steps key.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.executionObjectResponse"}}},"description":"Dry-run execution quote."},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.executionObjectResponse"}}},"description":"Execution created and paired transaction prepared."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Missing or invalid api token"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Conflict"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Internal Server Error"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"Bad Gateway"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/controllers.errorResponse"}}},"description":"No Solana durable nonce account available (bridge-in / out-op). Retry shortly."}},"summary":"Create a quote-backed execution","tags":["Executions"]}}},"components":{"schemas":{"controllers.createExecutionRequestDoc":{"properties":{"addressLookupTables":{"description":"AddressLookupTables are base58 Address Lookup Table account addresses\n(Solana destinations only). When set, the backend compresses matching step\naccounts into lookup indices and emits a v0 transaction so many-account\nactions fit under the packet size limit. Additive and ignored for EVM.","items":{"type":"string"},"type":"array"},"dry":{"type":"boolean"},"metadata":{"additionalProperties":{},"type":"object"},"outOperation":{"type":"boolean"},"publicKey":{"description":"PublicKey is the origin wallet's ed25519 key (ed25519:). Required for\nTON (address can't yield the pubkey) and must be the wallet's owner key. Ignored otherwise.","type":"string"},"quote":{"$ref":"#/components/schemas/controllers.createExecutionQuoteDoc"},"steps":{"description":"Steps are ExecutionStepEVM objects for EVM destinations. For Solana\ndestinations (type=solana) each step is an executionStepSolanaDoc instead,\nsent under this same steps key.","items":{"$ref":"#/components/schemas/controllers.executionStepEVMDoc"},"type":"array"},"type":{"enum":["evm","solana"],"type":"string"},"version":{"type":"string"}},"type":"object"},"controllers.createExecutionQuoteDoc":{"properties":{"amount":{"type":"string"},"deadline":{"type":"string"},"destinationAsset":{"type":"string"},"originAsset":{"type":"string"},"recipient":{"type":"string"},"slippageTolerance":{"type":"integer"},"swapType":{"enum":["EXACT_INPUT","EXACT_OUTPUT"],"type":"string"}},"type":"object"},"controllers.executionStepEVMDoc":{"properties":{"functionSignature":{"type":"string"},"metadata":{"$ref":"#/components/schemas/controllers.stepMetadataDoc"},"parameters":{"items":{"type":"object"},"type":"array"},"to":{"type":"string"},"value":{"type":"string"}},"type":"object"},"controllers.stepMetadataDoc":{"properties":{"description":{"type":"string"},"name":{"type":"string"}},"type":"object"},"controllers.executionObjectResponse":{"properties":{"result":{"$ref":"#/components/schemas/controllers.executionDoc"}},"type":"object"},"controllers.executionDoc":{"properties":{"createdAt":{"type":"string"},"details":{"$ref":"#/components/schemas/controllers.executionDetailsDoc"},"executionMode":{"enum":["quote_with_steps","steps_only"],"type":"string"},"id":{"type":"string"},"metadata":{"additionalProperties":{},"type":"object"},"quote":{"$ref":"#/components/schemas/controllers.executionQuoteDoc"},"status":{"enum":["CREATED","DEPOSIT_PENDING","DEPOSIT_PROCESSING","OPERATION_PENDING","OPERATION_PROCESSING","SUCCESS","DEPOSIT_FAILED","OPERATION_FAILED","EXPIRED"],"type":"string"},"steps":{"description":"Steps are ExecutionStepEVM objects for EVM executions. For Solana executions\n(type=solana) each item is an executionStepSolanaDoc instead, echoed under this\nsame steps key.","items":{"$ref":"#/components/schemas/controllers.executionStepEVMDoc"},"type":"array"},"type":{"enum":["evm","solana"],"type":"string"},"version":{"type":"string"}},"type":"object"},"controllers.executionDetailsDoc":{"properties":{"estimatedTime":{"type":"string"},"intermediaryAddress":{"type":"string"},"messageSigned":{"type":"boolean"},"messageToSign":{"type":"string"},"networkFee":{"type":"string"},"payload":{"$ref":"#/components/schemas/controllers.signingPayloadDoc"},"signingStandard":{"enum":["raw_ed25519","nep413","erc191","tip191","sep53","ton_connect"],"type":"string"}},"type":"object"},"controllers.signingPayloadDoc":{"properties":{"payload_bytes_base64":{"type":"string"},"payload_json":{"type":"string"},"standard":{"enum":["raw_ed25519","nep413","erc191","tip191","sep53","ton_connect"],"type":"string"}},"type":"object"},"controllers.executionQuoteDoc":{"properties":{"amount":{"type":"string"},"amountIn":{"type":"string"},"amountInUsd":{"type":"string"},"amountOut":{"type":"string"},"amountOutUsd":{"type":"string"},"deadline":{"type":"string"},"depositAddress":{"type":"string"},"depositMemo":{"type":"string"},"destinationAsset":{"type":"string"},"minAmountIn":{"type":"string"},"minAmountOut":{"type":"string"},"originAsset":{"type":"string"},"recipient":{"type":"string"},"swapType":{"enum":["EXACT_INPUT","EXACT_OUTPUT"],"type":"string"}},"type":"object"},"controllers.errorResponse":{"properties":{"error":{"type":"string"}},"type":"object"}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.intents.aurora.dev/api-reference/intents-connect-api-reference/request-an-execution.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.