Listing Endpoints

Fulfill a listing using a different token

Changed on

Get fulfillment data to buy one or more listings using a token on a different chain or a different token on the same chain. Supports cross-chain purchases and same-chain token swaps via the Relay protocol. Returns an ordered list of transactions to execute. Listings on EVM chains only; a listing on any other chain is rejected.

post/api/v2/listings/cross_chain_fulfillment_data

Request

Request body

recipientstring nullable

Optional recipient address for the purchased items

Example request

{
  "payment": {
    "chain": "base",
    "token_address": "0x0000000000000000000000000000000000000000"
  }
}

Response

Cross-chain fulfillment data retrieved successfully

Example response

{
  "transactions": [
    {
      "chain": "ethereum",
      "svm": {
        "instructions": [
          {
            "accounts": [
              {
                "pubkey": "So11111111111111111111111111111111111111112"
              }
            ],
            "data": "01020304",
            "program_id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"
          }
        ],
        "transaction_config": {
          "compute_unit_limit": 200000,
          "priority_fee_lamports": "5000"
        }
      }
    }
  ]
}

Changes

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      the request property became nullable

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status