Turn a quote into a signable transaction

Turn a quote into a signable transaction

post

Turn a quote into a transaction you can sign.

Pass one quote object from the quote endpoint, unmodified, together with the wallet that will sign. The response carries a transaction built and ready to sign, with a fresh blockhash on Solana and a simulation already run against it.

• Solana: transaction is a base64-encoded serialized VersionedTransaction. Deserialize, sign, and send it to the execute endpoint base64-encoded.

• EVM (Base): swapTxData holds the transaction fields to sign. When needsApproval is true, sign and send approvalTxData first and wait for it to confirm.

This step is optional for same-chain swaps, where the quote already carries signable transaction data — but it is required for swaps out of Solana to another chain, whose quotes carry routing instructions rather than a transaction. Preferring this endpoint everywhere means one signing path instead of one per route, and it applies the network fee floor that keeps Solana bridge transactions from being dropped while they wait to be included.

The transaction is not broadcast here. Send the signed result to the execute endpoint.

Authorizations

apikeystringRequired

API key for authentication

Body

A quote plus the wallet that will sign it.

chainstring · enumRequired

Chain the quote is on: 'solana' or 'base'

Example: solanaPossible values:

wallet_addressstringRequired

Wallet that will sign and send the transaction

Example: BqLNQpXhtRosNTFvJnCFbwtxUAmVoJBqYCKGYqA6vLzT

skip_simulationbooleanOptional

Skip the pre-signing simulation. Simulation catches failures before you spend a signature, so leave this off unless you are re-preparing a quote you have already validated.

Default: false

Responses

200

An unsigned transaction ready to sign

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/trade/prepare

POST /api/v1/trade/prepare HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "chain": "solana",
  "wallet_address": "BqLNQpXhtRosNTFvJnCFbwtxUAmVoJBqYCKGYqA6vLzT",
  "quote": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "skip_simulation": false
}

{
  "error": "text",
  "message": "text",
  "code": "missing_field",
  "status": 1,
  "request_id": null,
  "doc_url": "https://docs.nansen.ai/getting-started/error-handling#rate_limit_exceeded",
  "param": "text",
  "retry_after": 1,
  "detail": "No API key found in request"
}