---
title: "Create Dexscreener order"
method: POST
path: "/solana/dexscreener/create-order"
tags: ["Dexscreener"]
---

# Create Dexscreener order

`POST /solana/dexscreener/create-order`

## Request

- Base URL: `https://public-api-v2.bags.fm/api/v1`
- URL: `https://public-api-v2.bags.fm/api/v1/solana/dexscreener/create-order`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bags/apis/bags-public-api-v2/docs/solana/dexscreener/create-order/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a Dexscreener token info order. Returns a payment transaction that must be signed and submitted.

## Request body

- CreateDexscreenerOrderRequest
  - `tokenAddress` string, required: Solana public key of the token
  - `description` string, required: Token description for the Dexscreener listing
  - `iconImageUrl` string, uri, required: URL of the icon image
  - `headerImageUrl` string, uri, required: URL of the header image
  - `payerWallet` string, required: Solana public key of the payer wallet
  - `links` DexscreenerLink[]: Optional array of links to display on the listing
    - `url` string, uri, required: URL of the link
    - `label` string: Optional display label for the link
  - `payWithSol` boolean: Whether to pay with SOL instead of USDC

## Response `200`

Successfully created Dexscreener order

- object
  - `success` boolean, required
  - `response` object
    - `orderUUID` string, required: Unique identifier for the created order
    - `recipientWallet` string, required: Solana public key of the treasury wallet to send payment to
    - `priceUSDC` number, required: Price of the order in USDC
    - `transaction` string, required: Base58 encoded serialized payment transaction
    - `lastValidBlockHeight` number, required: Last valid block height for the transaction

## Other responses

- `400`: Bad request - Invalid parameters or validation errors
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/bags/apis/bags-public-api-v2.md) - [All operations](https://skmtc.dev/bags/apis/bags-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bags/apis/bags-public-api-v2/revisions/4a14b82cd39d?raw)