API docs by Redocly

Cardexscan APIs (1.0.1)

Download OpenAPI specification:

API Documentation for CDS Public. MIT Licensed. Subjected to personal use. Rate limiting is in effect. For Commercial Use, Connect with CDS Team.

Swaps

Get Aggregated Swaps Data

Authorizations:
noauthAuth
header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
object

Stringified JSON object

Responses

Request samples

Content type
application/json
{
  • "tokenInAmount": 1000,
  • "slippage": 1,
  • "tokenIn": "lovelace",
  • "tokenOut": {
    },
  • "blacklisted_dexes": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": null
}

Get Aggregated Swap Unsigned Tx CBOR

header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
object

Stringified JSON object

Responses

Request samples

Content type
application/json
{
  • "tokenInAmount": 5,
  • "slippage": 1,
  • "tokenIn": "lovelace",
  • "tokenOut": {
    },
  • "blacklisted_dexes": [
    ],
  • "userAddress": "addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Tokens

Get Order History

Get all historical trades

query Parameters
address
string
Example: address=addr1q8yx3zhvwv7ehxx9ma5f0h49wc2k56ptswamvzxduv875fn7vxlum3yvsmsjjvlghntrc3m0nrhw7jqk0hfa9ggzgq7qdrw6uq
header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

Get Trending Tokens

Get all trending tokens

query Parameters
timeframe
string
Example: timeframe=1 day
count
integer
Example: count=50
header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

Get All Token Trades

Get all token trades

query Parameters
timeframe
string
Example: timeframe=15 mins
limit
integer
Example: limit=10
order
string
Example: order=asc
header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

P2P marketplace

Create P2P Offer

Create new P2P offer for trading assets

header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
walletAddress
required
string

User's wallet address (required)

object

Asset being offered (defaults to ADA/lovelace)

offerAmount
required
number

Amount of the offer asset

object

Asset being requested (defaults to ADA/lovelace)

requestAmount
required
number

Amount of the requested asset

allowPartial
boolean

Allow partial fills (defaults to false)

minTakeAmount
number

Minimum amount for partial takes (defaults to offerAmount)

expirationHours
integer

Hours until offer expires (0 = no expiration)

Responses

Request samples

Content type
application/json
{
  • "walletAddress": "addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3",
  • "offerAsset": {
    },
  • "offerAmount": 1000,
  • "requestAsset": "lovelace",
  • "requestAmount": 5000000,
  • "allowPartial": true,
  • "minTakeAmount": 100,
  • "expirationHours": 24
}

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    }
}

Fill P2P Offer

Fully fill/Accept an existing P2P offer

header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
walletAddress
required
string

User's wallet address (required)

offerId
required
string

ID of the offer to fill (required)

Responses

Request samples

Content type
application/json
{
  • "walletAddress": "addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3",
  • "offerId": "offer_123abc"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    }
}

Get P2P Offers

Fetch all P2P offers

query Parameters
status
string
Example: status=all

Filter offers by status (e.g., 'all', 'open', 'filled', 'cancelled')

header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ]
}

Get My P2P Offers

Fetch all P2P offers created by the specified wallet address

query Parameters
walletAddress
required
string
Example: walletAddress=addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3

User's wallet address (required)

header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ]
}

Cancel P2P Offer

Cancel an existing P2P offer owned by the wallet

header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
walletAddress
required
string

User's wallet address (required)

offerId
required
string

ID of the offer to cancel (required)

Responses

Request samples

Content type
application/json
{
  • "walletAddress": "addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3",
  • "offerId": "offer_123abc"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    }
}

DCA (Dollar Cost Averaging)

Create DCA Order

Create a new DCA (Dollar Cost Averaging) order that automatically executes recurring swaps at specified intervals. Orders are executed by keeper bots when the next execution time is reached.

header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
walletAddress
required
string

User's wallet address (required)

required
string or object
required
string or object
perOrderAmount
required
number

Amount to swap per order (in token units, e.g. 5 = 5 ADA)

numOrders
required
integer

Total number of orders to execute

intervalMs
integer
Default: 3600000

Interval between orders in milliseconds (default 3600000 = 1 hour)

slippageBps
integer
Default: 50

Slippage tolerance in basis points (default 50 = 0.5%)

object

Minimum price constraint as a rational number (optional)

object

Maximum price constraint as a rational number (optional)

keeperFee
integer
Default: 500000

Keeper fee per order in lovelace (default 500000)

tokenInDecimals
integer
Default: 6

Decimals for tokenIn (default 6 for ADA)

Responses

Request samples

Content type
application/json
{
  • "walletAddress": "addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3",
  • "tokenIn": "lovelace",
  • "tokenOut": {
    },
  • "perOrderAmount": 5,
  • "numOrders": 3,
  • "intervalMs": 3600000,
  • "slippageBps": 50,
  • "keeperFee": 500000,
  • "tokenInDecimals": 6
}

Response samples

Content type
application/json
{
  • "success": true,
  • "txCbor": "84a500d90102..."
}

Cancel DCA Order

Cancel an existing DCA order. Only the owner of the order can cancel it. All remaining locked assets (unused tokenIn, keeper fees, batcher fees) are returned to the owner's wallet.

header Parameters
content-type
string
Example: application/json
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2
Request Body schema: application/json
walletAddress
required
string

User's wallet address (required)

orderId
required
string

Order ID in format {txHash}#{outputIndex} (required)

Responses

Request samples

Content type
application/json
{
  • "walletAddress": "addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3",
  • "orderId": "3f39bd440320357458d68392bfbd2320bf4524212f0c4ee4d87923f0af1c3f83#0"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "txCbor": "84a500d90102..."
}

Get My DCA Orders

Fetch all DCA orders created by the specified wallet address

query Parameters
walletAddress
required
string
Example: walletAddress=addr1qx2u9j732u24pzdgr7kv5s3mra5hldzgq6spgjclp02urdfsl0pf0vqz942h3gru5cudxjajqme6h886gpg5jdftzcyqqkjcj3

User's wallet address (required)

header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "orders": [
    ]
}

Get All Active DCA Orders

Fetch all active DCA orders on the platform

header Parameters
x-api-key
string
Example: 7c6095cf2eeeac500667241439ab5c3eac2488b9962526ca7f543d76b56a7b2

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "orders": [
    ]
}