Create an idempotent wallet-authorized swap operation.

Request#

POST /api/v1/swaps/prepare

Authentication is required. Supported credentials: a signed-in customer session token in Authorization: Bearer …. This route does not accept customer API keys.

Parameters

Request body

A body is required.

Content type: application/json

Type: object.

Additional fields are not allowed.

cURL

Create request.json using the request-body schema. The example sends the file bytes unchanged.

curl --fail-with-body --silent --show-error \
  --request POST \
  --url "https://launch-api.supanova.app/api/v1/swaps/prepare" \
  --header "Authorization: Bearer $SUPANOVA_SESSION_TOKEN" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @request.json

Responses#

201

A wallet action and operation record.

Content type: application/json

Type: one or more variants.

At least one of these variants must match:

• Variant 1: object · Schema 1.
• Variant 2: object · Schema 2.

400

The request is malformed or failed validation. Codes: VALIDATION_FAILED, IDEMPOTENCY_KEY_REQUIRED, AMBIGUOUS_CREDENTIALS, SERVICE_ACT_AS_REQUIRED.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

401

Credentials are missing, malformed, expired or revoked. Codes: AUTHENTICATION_REQUIRED, INVALID_AUTHORIZATION_HEADER, INVALID_ACCESS_TOKEN, SESSION_REVOKED.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

403

The credential may not call this route. Codes: ACCOUNT_RESTRICTED, ANONYMOUS_ACCOUNT_NOT_ALLOWED, API_KEY_ROUTE_NOT_ALLOWED, SERVICE_PARTY_NOT_ALLOWED, SERVICE_PRINCIPAL_NOT_ALLOWED, SIGNUP_NOT_INVITED.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

409

The request conflicts with current state, or the Idempotency-Key was reused with a different request (IDEMPOTENCY_KEY_CONFLICT; the former IDEMPOTENCY_CONFLICT is a deprecated alias, no longer returned, that clients handle the same way for one release). Codes: IDEMPOTENCY_KEY_CONFLICT, IDEMPOTENCY_CONFLICT.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

413

The request body exceeds the size limit.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

428

The signed-in account must accept the current product terms first. Codes: PRODUCT_LEGAL_ACCEPTANCE_REQUIRED.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

429

The caller exceeded an IP or principal request budget.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

503

A dependency is unavailable or the feature is not enabled on this deployment. Codes: AUTHENTICATION_UNAVAILABLE, AUTHORIZATION_UNAVAILABLE.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

default

Machine-readable API error. The HTTP status identifies the error class.

Content type: application/json

Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.

Nested schemas#

Field links above lead to the complete nested object, array, and variant definitions below. Required fields are scoped to their containing object.

Schema 1

Response 201 variant 1

Type: object.

Additional fields are not allowed.

Schema 2

Response 201 variant 2

Type: object.

Additional fields are not allowed.

Schema 3

Response 201 variant 1.operation

Type: object.

Additional fields are not allowed.

Schema 4

Response 201 variant 1.walletAction

Type: object.

Additional fields are not allowed.

Schema 5

Response 201 variant 2.walletAction

Type: object.

Additional fields are not allowed.

Schema 6

Response 201 variant 1.walletAction.intent

Type: object.

Additional fields are not allowed.

Schema 7

Response 201 variant 1.walletAction.request

Type: one or more variants.

At least one of these variants must match:

• Variant 1: object · Schema 13.
• Variant 2: null.

Schema 8

Response 201 variant 2.walletAction.intent

Type: object.

Additional fields are not allowed.

Schema 9

Response 201 variant 1.walletAction.intent.authority

Type: object.

Additional fields are not allowed.

Schema 10

Response 201 variant 1.walletAction.intent.buyInstrument

Type: object.

Additional fields are not allowed.

Schema 11

Response 201 variant 1.walletAction.intent.creatorRevenueAllocations

Type: array of exactly one variant.

min items: 1; max items: 2

Array items: exactly one variant · Schema 20.

Schema 12

Response 201 variant 1.walletAction.intent.route

Type: array of object.

min items: 1; max items: 2

Array items: object · Schema 21.

Schema 13

Response 201 variant 1.walletAction.request variant 1

Type: object.

Additional fields are not allowed.

Schema 14

Response 201 variant 2.walletAction.intent.authority

Type: object.

Additional fields are not allowed.

Schema 15

Response 201 variant 2.walletAction.intent.creatorRevenueAllocations

Type: array of object.

min items: 1; max items: 1

Array items: object · Schema 28.

Schema 16

Response 201 variant 2.walletAction.intent.route

Type: array of object.

min items: 1; max items: 1

Array items: object · Schema 21.

Schema 17

Response 201 variant 1.walletAction.intent.authority.legs

Type: array of exactly one variant.

min items: 1; max items: 2

Array items: exactly one variant · Schema 29.

Schema 18

Response 201 variant 1.walletAction.intent.authority.policy

Type: object.

Additional fields are not allowed.

Schema 19

Response 201 variant 1.walletAction.intent.authority.replay

Type: object.

Additional fields are not allowed.

Schema 20

Response 201 variant 1.walletAction.intent.creatorRevenueAllocations item

Type: exactly one variant.

Exactly one of these variants must match:

• Variant 1: object · Schema 31.
• Variant 2: object · Schema 32.

Schema 21

Response 201 variant 1.walletAction.intent.route item

Type: object.

Additional fields are not allowed.

Schema 22

Response 201 variant 1.walletAction.request variant 1.actAs

Type: array of string.

min items: 1; max items: 8

Array items: string. min length: 3; max length: 512

Schema 23

Response 201 variant 1.walletAction.request variant 1.signedBy

Type: one or more variants.

At least one of these variants must match:

• Variant 1: string. min length: 4; max length: 160
• Variant 2: null.

Schema 24

Response 201 variant 1.walletAction.request variant 1.preparedTransaction

Type: one or more variants.

At least one of these variants must match:

• Variant 1: string. max length: 4194304
• Variant 2: null.

Schema 25

Response 201 variant 1.walletAction.request variant 1.preparedTransactionHash

Type: one or more variants.

At least one of these variants must match:

• Variant 1: string. max length: 512
• Variant 2: null.

Schema 26

Response 201 variant 2.walletAction.intent.authority.legs

Type: array of exactly one variant.

min items: 1; max items: 1

Array items: exactly one variant · Schema 33.

Schema 27

Response 201 variant 2.walletAction.intent.authority.policy

Type: object.

Additional fields are not allowed.

Schema 28

Response 201 variant 2.walletAction.intent.creatorRevenueAllocations item

Type: object.

Additional fields are not allowed.

Schema 29

Response 201 variant 1.walletAction.intent.authority.legs item

Type: exactly one variant.

Exactly one of these variants must match:

• Variant 1: object · Schema 35.
• Variant 2: object · Schema 36.
• Variant 3: object · Schema 37.

Schema 30

Response 201 variant 1.walletAction.intent.authority.policy.snapshot

Type: object.

Additional fields are not allowed.

Schema 31

Response 201 variant 1.walletAction.intent.creatorRevenueAllocations item variant 1

Type: object.

Additional fields are not allowed.

Schema 32

Response 201 variant 1.walletAction.intent.creatorRevenueAllocations item variant 2

Type: object.

Additional fields are not allowed.

Schema 33

Response 201 variant 2.walletAction.intent.authority.legs item

Type: exactly one variant.

Exactly one of these variants must match:

• Variant 1: object · Schema 43.
• Variant 2: object · Schema 44.

Schema 34

Response 201 variant 2.walletAction.intent.creatorRevenueAllocations item.policy

Type: object.

Additional fields are not allowed.

Schema 35

Response 201 variant 1.walletAction.intent.authority.legs item variant 1

Type: object.

Additional fields are not allowed.

Schema 36

Response 201 variant 1.walletAction.intent.authority.legs item variant 2

Type: object.

Additional fields are not allowed.

Schema 37

Response 201 variant 1.walletAction.intent.authority.legs item variant 3

Type: object.

Additional fields are not allowed.

Schema 38

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.amm

Type: object.

Additional fields are not allowed.

Schema 39

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.curve

Type: object.

Additional fields are not allowed.

Schema 40

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.creatorRevenue

Type: object.

Additional fields are not allowed.

Schema 41

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.quote

Type: object.

Additional fields are not allowed.

Schema 42

Response 201 variant 1.walletAction.intent.creatorRevenueAllocations item variant 1.policy

Type: object.

Additional fields are not allowed.

Schema 43

Response 201 variant 2.walletAction.intent.authority.legs item variant 1

Type: object.

Additional fields are not allowed.

Schema 44

Response 201 variant 2.walletAction.intent.authority.legs item variant 2

Type: object.

Additional fields are not allowed.

Schema 45

Response 201 variant 1.walletAction.intent.authority.legs item variant 1.creatorRevenue

Type: exactly one variant.

Exactly one of these variants must match:

• Variant 1: object · Schema 58.
• Variant 2: object · Schema 59.

Schema 46

Response 201 variant 1.walletAction.intent.authority.legs item variant 1.after

Type: object.

Additional fields are not allowed.

Schema 47

Response 201 variant 1.walletAction.intent.authority.legs item variant 1.limits

Type: object.

Additional fields are not allowed.

Schema 48

Response 201 variant 1.walletAction.intent.authority.legs item variant 2.after

Type: object.

Additional fields are not allowed.

Schema 49

Response 201 variant 1.walletAction.intent.authority.legs item variant 2.limits

Type: object.

Additional fields are not allowed.

Schema 50

Response 201 variant 1.walletAction.intent.authority.legs item variant 3.after

Type: object.

Additional fields are not allowed.

Schema 51

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.amm.fee

Type: object.

Additional fields are not allowed.

Schema 52

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.amm.invariant

Type: object.

Additional fields are not allowed.

Schema 53

Response 201 variant 1.walletAction.intent.authority.policy.snapshot.amm.rounding

Type: object.

Additional fields are not allowed.

Schema 54

Response 201 variant 2.walletAction.intent.authority.legs item variant 1.creatorRevenue

Type: object.

Additional fields are not allowed.

Schema 55

Response 201 variant 2.walletAction.intent.authority.legs item variant 1.market

Type: object.

Additional fields are not allowed.

Schema 56

Response 201 variant 2.walletAction.intent.authority.legs item variant 1.after

Type: object.

Additional fields are not allowed.

Schema 57

Response 201 variant 2.walletAction.intent.authority.legs item variant 2.after

Type: object.

Additional fields are not allowed.

Schema 58

Response 201 variant 1.walletAction.intent.authority.legs item variant 1.creatorRevenue variant 1

Type: object.

Additional fields are not allowed.

Schema 59

Response 201 variant 1.walletAction.intent.authority.legs item variant 1.creatorRevenue variant 2

Type: object.

Additional fields are not allowed.

Schema 60

Response 201 variant 1.walletAction.intent.authority.legs item variant 1.limits.exactFinalGrossCc

Type: one or more variants.

At least one of these variants must match:

• Variant 1: string. pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$
• Variant 2: null.

Schema 61

Response 201 variant 2.walletAction.intent.authority.legs item variant 1.market.economics

Type: object.

Additional fields are not allowed.

Schema 62

Response 201 variant 2.walletAction.intent.authority.legs item variant 1.market.feeConfig

Type: object.

Additional fields are not allowed.

Source contract#

This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.