> For the complete documentation index, see [llms.txt](https://docs.ordinalsbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ordinalsbot.com/marketplace-1/transfer-ordinals.md).

# Transfer Ordinals

Transfer ordinal to another address

{% hint style="info" %}
An API Key is required to interact with MarketPlace APIs. Please contact us to get an API Key and get started.
{% endhint %}

This endpoint creates a psbt to transfer one or more ordinals. Calling the endpoint returns a psbt which needs to be signed and broadcast by the seller's ordinal wallet address.<br>

### `POST` Transfer one or more Ordinals

## Transfer one or more ordinals

<mark style="color:green;">`POST`</mark> `https://api.ordinalsbot.com/marketplace/transfer-ordinals`

API Key is required in the header:

`headers: { 'x-api-key': '<YOUR_API_KEY>', ...otherHeaders }`<br>

`transfer` is an array with one or more objects. Each object needs an ordinal Id and receiver address.\
\
Example Request Body:\
\
`{`\
&#x20;  `"transfer": [`\
&#x20;      `{`\
&#x20;          `"ordinalId": "5f251...b9i0",`\
&#x20;          `"receiverOrdinalAddress": "tb1...yk3"`\
&#x20;      `},`

&#x20;      `{`\
&#x20;          `"ordinalId": "2a920...c0i0",`\
&#x20;          `"receiverOrdinalAddress": "tb1...ze2"`\
&#x20;      `}`\
&#x20;  `],`\
&#x20;  `"senderPaymentAddress": "2N6Z...bKL",`\
&#x20;  `"senderPaymentPublicKey": "0335...c05",`\
&#x20;  `"senderOrdinalPublicKey": "e581...a26"`\
&#x20;`}`

\
This will return a PSBT. The PSBT has to be signed and broadcast.

#### Request Body

| Name                                                     | Type   | Description                                                                                                         |
| -------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------- |
| sellerOrdinalPublicKey<mark style="color:red;">\*</mark> | String | The public key for the wallet address that owns the ordinal                                                         |
| transfer<mark style="color:red;">\*</mark>               | Array  | An array of objects. Each object should have an id for the ordinal and an address for the receiver of that ordinal. |
| sellerPaymentAddress<mark style="color:red;">\*</mark>   | String | Payment wallet address for the seller, this wallet address will receive the payment the ordinal is sold             |
| senderPaymentPublicKey<mark style="color:red;">\*</mark> | String | The public key for the payment wallet, this will be used for fees                                                   |

{% tabs %}
{% tab title="200: OK " %}

```json

{
   "psbtBase64": "cHNidP8BA…yzcAAAAAAA==",
   "senderOrdinalInputs": [
       0,
       1
   ],
   "senderPaymentInputs": [
       2
   ]
}


```

{% endtab %}

{% tab title="500: Internal Server Error " %}

```json
{
    status: 'error',
    error: 'error reason'
}
```

{% endtab %}
{% endtabs %}