carp (3.0.0)

Download OpenAPI specification:Download

License: MIT

API for the Postgres database generated by Carp

AddressUsed

Ordered lexicographically (order is not maintained)

Warning: the pagination on this endpoint is NOT whether or not an address was used during this block interval, but rather whether or not the address was first used within this interval.

Note: this endpoint only returns addresses that are in a block. Use another tool to see mempool information

Request Body schema: application/json

required	Array of CredentialHex (string) or Bech32FullAddress (string) or Bech32Credential (string) or Base58Address (string) (Address)
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"addresses": ["addr1qxzksn47upfu4fwqfmxx29rn5znlkw3ag98ul8rgndwm79aaql88xw6ez84k2ln6lawnt79sdqh7qwq0wcs672auktmsawshfe"
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

{"addresses": ["addr1qxzksn47upfu4fwqfmxx29rn5znlkw3ag98ul8rgndwm79aaql88xw6ez84k2ln6lawnt79sdqh7qwq0wcs672auktmsawshfe"
]
}

AssetUtxos

Returns utxo entries filtered either by cip 14 fingerprint or by policy id.

This is useful to keep track of the utxo set of a particular asset.

Request Body schema: application/json

limit	number <double>
	object (SlotLimits)
policyIds	Array of strings (PolicyId)
fingerprints	Array of strings (Cip14Fingerprint)
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"limit": 0,
"slotLimits": {"to": 0,
"from": 0
},
"policyIds": ["b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
],
"fingerprints": ["asset1c43p68zwjezc7f6w4w9qkhkwv9ppwz0f7c3amw"
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

[{"block": "string",
"txId": "string",
"payload": [{"utxo": {"index": 0,
"tx": "string"
},
"slot": 0,
"paymentCred": "string",
"assetName": "42657272794e617679",
"policyId": "string",
"cip14Fingerprint": "string",
"amount": "string"
}
]
}
]

BlockLatest

Get the latest block. Useful for checking synchronization process and pagination

Request Body schema: application/json

offset

required

number <double>

Note: an offset of -1 is treated the same as an offset of +1

It's usually best to avoid pagination on the latest block as in Cardano, small rollbacks of 1~2 block are very frequent and expected (read Ouroboros for why) That means that using this block for pagination will often lead to your pagination being invalidated by a rollback To avoid this, you can pass an offset from the tip for more stable pagination

Responses

Request samples

Payload

Content type

application/json

{"offset": 0
}

Response samples

200
400
409

Content type

application/json

{"block": {"slot": 4924800,
"epoch": 209,
"height": 4512067,
"hash": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8",
"era": 1
}
}

AddressesForCredential

Ordered by the first time the address was seen on-chain

Note: this endpoint only returns addresses that are in a block. Use another tool to see mempool information

Request Body schema: application/json

after	string (Bech32FullAddress)
required	Array of CredentialHex (string) or Bech32Credential (string) (Credential)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"after": "stake1ux236z4g4r4pztn5v69txyj2yq6a3esq5x4p4stxydra7zsnv25ue",
"credentials": ["8200581c8baf48931c5187cd59fde553f4e7da2e1a2aa9202ec6e67815cb3f8a"
],
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
422

Content type

application/json

{"addresses": ["stake1ux236z4g4r4pztn5v69txyj2yq6a3esq5x4p4stxydra7zsnv25ue"
],
"pageInfo": {"hasNextPage": false
}
}

DelegationForAddress

Returns the pool of the last delegation for this address.

Note: the tx can be in the current epoch, so the delegation may not be in effect yet.

Request Body schema: application/json

required

object

required

CredentialHex (string) or Bech32FullAddress (string) or Bech32Credential (string) or Base58Address (string) (Address)

Supported types:

Credential hex (8200581c...) - note this is not a keyhash (it contains a credential type prefix)
Bech32 full address (addr / addr_test / stake / stake_test)
Bech32 credentials ( addr_vkh, script, etc.) - this is the recommended approach
Legacy Byron format (Ae2, Dd, etc.)

Note: we recommend avoiding to query base addresses history using bech32 As Cardano UTXO spendability depends only on the payment credential and not the full base address The result will also miss transactions that are only related to the payment key of the address ex: the payment key is used in a multisig

Note: using two different address representations in the same query will hurt performance (ex: addr1 and addr_vkh1) This because under-the-hood this will run multiple independent SQL queries for the different formats

Warning: querying reward bech32 addresses is equivalent to querying the stake credential inside it This may return more results than expected (ex: a multisig containing the staking key of the wallet)

Responses

Request samples

Payload

Content type

application/json

{"until": {"absoluteSlot": 0
},
"address": "addr1qxzksn47upfu4fwqfmxx29rn5znlkw3ag98ul8rgndwm79aaql88xw6ez84k2ln6lawnt79sdqh7qwq0wcs672auktmsawshfe"
}

Response samples

200
400
409
422

Content type

application/json

{"txId": "string",
"pool": "string"
}

DelegationForPool

Returns the list of delegations for the provided pools. The pool field in the response will be null when the address was previously delegating to a pool in the input, but now the delegation is moved to a pool outside the list, or when the staking key is unregistered.

This is useful to keep track of the delegators for a particular pool.

Request Body schema: application/json

limit	number <double>
	object (SlotLimits)
pools required	Array of strings (Pool)
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"limit": 0,
"slotLimits": {"to": 0,
"from": 0
},
"pools": ["8200581c8baf48931c5187cd59fde553f4e7da2e1a2aa9202ec6e67815cb3f8a"
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

[{"block": "string",
"txId": "string",
"payload": [{"slot": 0,
"pool": "8200581c8baf48931c5187cd59fde553f4e7da2e1a2aa9202ec6e67815cb3f8a",
"credential": "addr1qxzksn47upfu4fwqfmxx29rn5znlkw3ag98ul8rgndwm79aaql88xw6ez84k2ln6lawnt79sdqh7qwq0wcs672auktmsawshfe"
}
]
}
]

DexLastPrice

Gets the swap prices for the given liquidity pool and asset pairs. Operation "mean" is not AVG from the last values, but the remaining amount of assets on the pool output

Request Body schema: application/json

type required	string (PriceType) Enum: "buy" "sell" "mean"
required	Array of objects

Responses

Request samples

Payload

Content type

application/json

{"type": "buy",
"assetPairs": [{"asset2": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"asset1": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
}
}
]
}

Response samples

200
400
409
422

Content type

application/json

{"lastPrice": [{"dex": "WingRiders",
"amount2": "2042352568679",
"amount1": "2042352568679",
"asset2": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"asset1": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
}
}
]
}

DexMeanPrice

Gets the mean prices for the given liquidity pool and asset pairs. Mean is not AVG from the last values, but the remaining amount of assets on the pool output

Request Body schema: application/json

limit	number <double> Defaults to `DEX_PRICE_LIMIT.RESPONSE`
dexes required	Array of strings (Dex) Items Enum: "WingRiders" "SundaeSwap" "MinSwap"
required	Array of objects
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"limit": 0,
"dexes": ["WingRiders"
],
"assetPairs": [{"asset2": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"asset1": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
}
}
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

{"meanPrices": [{"amount2": "2042352568679",
"amount1": "2042352568679",
"asset2": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"asset1": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"dex": "WingRiders",
"tx_hash": "string"
}
]
}

DexSwap

Gets the swap prices for the given liquidity pool and asset pairs.

Request Body schema: application/json

limit	number <double> Defaults to `DEX_PRICE_LIMIT.RESPONSE`
required	Array of objects
dexes required	Array of strings (Dex) Items Enum: "WingRiders" "SundaeSwap" "MinSwap"
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"limit": 0,
"assetPairs": [{"asset2": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"asset1": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
}
}
],
"dexes": ["WingRiders"
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

{"swap": [{"direction": "buy",
"amount2": "2042352568679",
"amount1": "2042352568679",
"asset2": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"asset1": {"assetName": "42657272794e617679",
"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
},
"dex": "WingRiders",
"tx_hash": "string"
}
]
}

MetadataNft

Gets the CIP25 metadata for given <policy, asset_name> pairs

Note: policy IDs and asset names MUST be in hex strings. Do not use UTF8 asset names.

Note: This endpoint returns the NFT metadata as a CBOR object and NOT JSON. You may expect a JSON object, but actually Cardano has no concept of on-chain JSON. In fact, on-chain JSON is not even possible! Instead, Cardano stores metadata as CBOR which can then be converted to JSON The conversion of CBOR to JSON is project-dependent, and so Carp instead returns the raw cbor It's up to you to choose how you want to do the JSON conversion. The common case is handled inside the Carp client library.

Request Body schema: application/json

assets

required

object

Responses

Request samples

Payload

Content type

application/json

{"assets": {"b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f": ["42657272794e617679"
]
}
}

Response samples

200
400
422

Content type

application/json

{"cip25": {"b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f": {"42657272794e617679": "a365636f6c6f72672330303030383065696d616765783a697066733a2f2f697066732f516d534b593167317a5375506b3536635869324b38524e766961526b44485633505a756a7474663755676b343379646e616d656a4265727279204e617679"
}
}
}

MintBurnHistory

Gets mint and burn events in the provided slot range, optionally filtering by policyId(s). A burn event is a mint with a negative value.

Request Body schema: application/json

limit	number <double>
	object (SlotLimits)
policyIds	Array of strings (PolicyId)
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"limit": 0,
"slotLimits": {"to": 0,
"from": 0
},
"policyIds": ["b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

[{"block": "4e90f1d14ad742a1c0e094a89ad180b896068f93fc3969614b1c53bac547b374",
"txId": "28eb069e3e8c13831d431e3b2e35f58525493ab2d77fde83184993e4aa7a0eda",
"metadata": "string",
"actionSlot": 512345,
"outputAddresses": {"8200581c4b2e7295ac876cfdf70e82c1cb8df3ee5cb23d93949e3322230fc447": [{"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f",
"assetName": "42657272794e617679",
"amount": "1"
}
]
},
"inputAddresses": {"8200581c4b2e7295ac876cfdf70e82c1cb8df3ee5cb23d93949e3322230fc447": [{"policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f",
"assetName": "42657272794e617680",
"amount": "2"
}
]
},
"assets": {"b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f": {"42657272794e617679": "1",
"42657272794e617680": "-2"
}
}
}
]

ProjectedNftRange

Query any projected NFT. Learn morehere.

Request Body schema: application/json

limit	number <double>
	object (SlotLimits)
address	string
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"limit": 0,
"slotLimits": {"to": 0,
"from": 0
},
"address": "string",
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

[{"txId": "28eb069e3e8c13831d431e3b2e35f58525493ab2d77fde83184993e4aa7a0eda",
"block": "string",
"payload": [{"forHowLong": "1701266986000",
"plutusDatum": "d8799fd8799f581c9040f057461d9adc09108fe5cb630077cf75c6e981d3ed91f6fb18f6ffd87980ff",
"status": "Lock",
"amount": "1",
"assetName": "415045",
"policyId": "96f7dc9749ede0140f042516f4b723d7261610d6b12ccb19f3475278",
"previousTxOutputIndex": 1,
"previousTxHash": "28eb069e3e8c13831d431e3b2e35f58525493ab2d77fde83184993e4aa7a0eda",
"actionOutputIndex": 1,
"ownerAddress": "9040f057461d9adc09108fe5cb630077cf75c6e981d3ed91f6fb18f6",
"actionSlot": 512345
}
]
}
]

TransactionHistory

Ordered by <block.height, transaction.tx_index>

Note: this endpoint only returns txs that are in a block. Use another tool to see mempool for txs not in a block

Request Body schema: application/json

withInputContext	boolean If this is set to true, the result includes the input addresses (which are not part of the tx), and the metadata (if any)
	object (SlotLimits)
limit	number <double> Defaults to `ADDRESS_LIMIT.RESPONSE`
relationFilter	number <double> (RelationFilter) ([01]?[0-9]?[0-9]\|2[0-4][0-9]\|25[0-5]) Filter which uses of the address are considered relevant for the query. This is a bitmask, so you can combine multiple options ex: `RelationFilterType.Input \| RelationFilterType.Output` Note: relations only apply to credentials and not to full bech32 addresses
required	Array of CredentialHex (string) or Bech32FullAddress (string) or Bech32Credential (string) or Base58Address (string) (Address)
	object (BlockTxPair)
untilBlock required	string[0-9a-fA-F]{64} block hash - inclusive

Responses

Request samples

Payload

Content type

application/json

{"withInputContext": true,
"slotLimits": {"to": 0,
"from": 0
},
"limit": 0,
"relationFilter": 255,
"addresses": ["addr1qxzksn47upfu4fwqfmxx29rn5znlkw3ag98ul8rgndwm79aaql88xw6ez84k2ln6lawnt79sdqh7qwq0wcs672auktmsawshfe"
],
"after": {"tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
"block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
},
"untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response samples

200
400
409
422

Content type

application/json

{"transactions": [{"transaction": {"inputCredentials": ["string"
],
"metadata": "string",
"payload": "84a500818258209cb4f8c2eecccc9f1e13768046f37ef56dcb5a4dc44f58907fe4ae21d7cf621d020181825839019cb581f4337a6142e477af6e00fe41b1fc4a5944a575681b8499a3c0bd07ce733b5911eb657e7aff5d35f8b0682fe0380f7621af2bbcb2f71b0000000586321393021a0002a389031a004b418c048183028200581cbd07ce733b5911eb657e7aff5d35f8b0682fe0380f7621af2bbcb2f7581c53215c471b7ac752e3ddf8f2c4c1e6ed111857bfaa675d5e31ce8bcea1008282582073e584cda9fe483fbefb81c251e616018a2b493ef56820f0095b63adede54ff758404f13df42ef1684a3fd55255d8368c9ecbd15b55e2761a2991cc4f401a753c16d6da1da158e84b87b4de9715af7d9adc0d79a7c1f2c3097228e02b20be4616a0c82582066c606974819f457ceface78ee3c4d181a84ca9927a3cfc92ef8c0b6dd4576e8584014ae9ee9ed5eb5700b6c5ac270543671f5d4f943d4726f4614dc061174ee29db44b9e7fc58e6c98c13fad8594f2633c5ec70a9a87f5cbf130308a42edb553001f5f6",
"hash": "011b86557367525891331b4bb985545120efc335b606d6a1c0d5a35fb330f421"
},
"block": {"slot": 4924800,
"epoch": 209,
"height": 4512067,
"hash": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8",
"era": 1,
"isValid": true,
"indexInBlock": 0
}
}
]
}

TransactionOutput

Get the outputs for given <tx hash, output index> pairs.

This endpoint will return both used AND unused outputs

Note: this endpoint only returns txs that are in a block. Use another tool to see mempool for txs not in a block

Request Body schema: application/json

required

Array of objects (UtxoPointer)

Array

index required	number <double>
txHash required	string[0-9a-fA-F]{64}

Responses

Request samples

Payload

Content type

application/json

{"utxoPointers": [{"index": 0,
"txHash": "011b86557367525891331b4bb985545120efc335b606d6a1c0d5a35fb330f421"
}
]
}

Response samples

200
400
422

Content type

application/json

{"utxos": [{"utxo": {"index": 0,
"txHash": "011b86557367525891331b4bb985545120efc335b606d6a1c0d5a35fb330f421",
"payload": "825839019cb581f4337a6142e477af6e00fe41b1fc4a5944a575681b8499a3c0bd07ce733b5911eb657e7aff5d35f8b0682fe0380f7621af2bbcb2f71b0000000586321393"
},
"block": {"slot": 4924800,
"epoch": 209,
"height": 4512067,
"hash": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8",
"era": 1,
"isValid": true,
"indexInBlock": 0
}
}
]
}