List smart contracts

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/smart_contracts \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "smart_contract_id": "a50c4ee4-affa-408c-ae22-c4312e42966d",
      "network_id": "base-mainnet",
      "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
      "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "contract_name": "my contract",
      "deployer_address": "0x1234567890abcdef1234567890abcdef12345678",
      "type": "erc20",
      "options": {
        "name": "MyToken",
        "symbol": "MTK",
        "total_supply": "1000000000000000000000"
      },
      "abi": "[ { name: \"mint\", type: \"function\", inputs: [ { name: \"to\", type: \"address\" }, { name: \"amount\", type: \"uint256\" }, ], outputs: [], stateMutability: \"nonpayable\", } ]",
      "transaction": {
        "network_id": "base-sepolia",
        "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "unsigned_payload": "<string>",
        "status": "pending",
        "signed_payload": "<string>",
        "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "content": {
          "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "gas": 1000,
          "gas_price": 1000,
          "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "input": "<string>",
          "nonce": 136,
          "index": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "value": 100,
          "type": 2,
          "max_fee_per_gas": 190,
          "max_priority_fee_per_gas": 100,
          "priority_fee_per_gas": 1000,
          "transaction_access_list": {
            "access_list": [
              {
                "address": "<string>",
                "storage_keys": [
                  "<string>"
                ]
              }
            ]
          },
          "flattened_traces": [
            {
              "error": "<string>",
              "type": "<string>",
              "from": "<string>",
              "to": "<string>",
              "value": "<string>",
              "gas": 123,
              "gas_used": 123,
              "input": "<string>",
              "output": "<string>",
              "sub_traces": 123,
              "trace_address": [
                123
              ],
              "trace_type": "<string>",
              "call_type": "<string>",
              "trace_id": "<string>",
              "status": 123,
              "block_hash": "<string>",
              "block_number": 123,
              "transaction_hash": "<string>",
              "transaction_index": 123
            }
          ],
          "block_timestamp": "2023-04-01T12:00:00Z",
          "mint": "0",
          "rlp_encoded_tx": "0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"
        }
      }
    }
  ],
  "has_more": true,
  "next_page": "eyJsYXN0X2V2ZW50X2lkIjoiMTIzNDU2Nzg5MCJ9"
}

GET

smart_contracts

List smart contracts

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/smart_contracts \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "smart_contract_id": "a50c4ee4-affa-408c-ae22-c4312e42966d",
      "network_id": "base-mainnet",
      "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
      "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "contract_name": "my contract",
      "deployer_address": "0x1234567890abcdef1234567890abcdef12345678",
      "type": "erc20",
      "options": {
        "name": "MyToken",
        "symbol": "MTK",
        "total_supply": "1000000000000000000000"
      },
      "abi": "[ { name: \"mint\", type: \"function\", inputs: [ { name: \"to\", type: \"address\" }, { name: \"amount\", type: \"uint256\" }, ], outputs: [], stateMutability: \"nonpayable\", } ]",
      "transaction": {
        "network_id": "base-sepolia",
        "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "unsigned_payload": "<string>",
        "status": "pending",
        "signed_payload": "<string>",
        "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "content": {
          "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "gas": 1000,
          "gas_price": 1000,
          "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "input": "<string>",
          "nonce": 136,
          "index": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "value": 100,
          "type": 2,
          "max_fee_per_gas": 190,
          "max_priority_fee_per_gas": 100,
          "priority_fee_per_gas": 1000,
          "transaction_access_list": {
            "access_list": [
              {
                "address": "<string>",
                "storage_keys": [
                  "<string>"
                ]
              }
            ]
          },
          "flattened_traces": [
            {
              "error": "<string>",
              "type": "<string>",
              "from": "<string>",
              "to": "<string>",
              "value": "<string>",
              "gas": 123,
              "gas_used": 123,
              "input": "<string>",
              "output": "<string>",
              "sub_traces": 123,
              "trace_address": [
                123
              ],
              "trace_type": "<string>",
              "call_type": "<string>",
              "trace_id": "<string>",
              "status": 123,
              "block_hash": "<string>",
              "block_number": 123,
              "transaction_hash": "<string>",
              "transaction_index": 123
            }
          ],
          "block_timestamp": "2023-04-01T12:00:00Z",
          "mint": "0",
          "rlp_encoded_tx": "0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"
        }
      }
    }
  ],
  "has_more": true,
  "next_page": "eyJsYXN0X2V2ZW50X2lkIjoiMTIzNDU2Nzg5MCJ9"
}

Authorizations

Authorization

string

header

required

Enter your JSON Web Token (JWT) here. Refer to the Generate JWT section of our Authentication docs for information on how to generate your Bearer Token.

Query Parameters

page

string

Pagination token for retrieving the next set of results.

Response

The list of smart contracts

data

object[]

required

Show child attributes

data.smart_contract_id

string

required

The unique identifier of the smart contract

Example:

"a50c4ee4-affa-408c-ae22-c4312e42966d"

data.network_id

string

required

Blockchain network identifier.

Example:

"base-mainnet"

data.wallet_id

string

required

The ID of the wallet that deployed the smart contract

Example:

"d91d652b-d020-48d4-bf19-5c5eb5e280c7"

data.contract_address

string

required

The EVM address of the smart contract

Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

data.contract_name

string

required

The name of the smart contract

Example:

"my contract"

data.deployer_address

string

required

The EVM address of the account that deployed the smart contract

Example:

"0x1234567890abcdef1234567890abcdef12345678"

data.type

enum<string>

required

The type of the smart contract.

Available options:

erc20,

erc721,

erc1155,

custom

Example:

"erc20"

data.options

object

required

Options for smart contract creation Options for token contract creation

Option 1
Option 2
Option 3

Show child attributes

data.options.name

string

required

The name of the token

Example:

"MyToken"

data.options.symbol

string

required

The symbol of the token

Example:

"MTK"

data.options.total_supply

string

required

The total supply of the token denominated in the whole amount of the token.

Example:

"1000000000000000000000"

data.abi

string

required

The JSON-encoded ABI of the contract

Example:

"[ { name: \"mint\", type: \"function\", inputs: [ { name: \"to\", type: \"address\" }, { name: \"amount\", type: \"uint256\" }, ], outputs: [], stateMutability: \"nonpayable\", } ]"

data.transaction

object

required

The transaction that will deploy the smart contract onchain.

Show child attributes

data.transaction.network_id

string

required

Blockchain network identifier.

Example:

"base-sepolia"

data.transaction.from_address_id

string

required

The onchain address of the sender

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

data.transaction.unsigned_payload

string

required

The unsigned payload of the transaction. This is the payload that needs to be signed by the sender.

data.transaction.status

enum<string>

required

The status of the transaction.

Available options:

pending,

signed,

broadcast,

complete,

failed,

unspecified

data.transaction.signed_payload

string

The signed payload of the transaction. This is the payload that has been signed by the sender.

data.transaction.transaction_hash

string

The hash of the transaction

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.transaction.transaction_link

string

The link to view the transaction on a block explorer. This is optional and may not be present for all transactions.

Example:

"https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.transaction.content

object

Show child attributes

data.transaction.content.from

string

required

The onchain address of the sender.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

data.transaction.content.to

string

required

The onchain address of the receiver.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

data.transaction.content.gas

integer<uint64>

The amount of gas spent in the transaction.

Example:

1000

data.transaction.content.gas_price

integer<uint64>

The price per gas spent in the transaction in atomic units of the native asset.

Example:

1000

data.transaction.content.hash

string

The hash of the transaction as a hexadecimal string, prefixed with 0x.

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.transaction.content.input

string

The input data of the transaction.

data.transaction.content.nonce

integer<uint64>

The nonce of the transaction in the source address.

Example:

136

data.transaction.content.index

integer<uint64>

The index of the transaction in the block.

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.transaction.content.value

string

The value of the transaction in atomic units of the native asset.

Example:

100

data.transaction.content.type

integer<uint64>

The EIP-2718 transaction type. See https://eips.ethereum.org/EIPS/eip-2718 for more details.

Example:

2

data.transaction.content.max_fee_per_gas

integer<uint64>

The max fee per gas as defined in EIP-1559. https://eips.ethereum.org/EIPS/eip-1559 for more details.

Example:

190

data.transaction.content.max_priority_fee_per_gas

integer<uint64>

The max priority fee per gas as defined in EIP-1559. https://eips.ethereum.org/EIPS/eip-1559 for more details.

Example:

100

data.transaction.content.priority_fee_per_gas

integer<uint64>

The confirmed priority fee per gas as defined in EIP-1559. https://eips.ethereum.org/EIPS/eip-1559 for more details.

Example:

1000

data.transaction.content.transaction_access_list

object

The transaction access list as defined in EIP-2930. https://eips.ethereum.org/EIPS/eip-2930 for more details.

Show child attributes

data.transaction.content.transaction_access_list.access_list

object[]

Show child attributes

data.transaction.content.transaction_access_list.access_list.address

string

data.transaction.content.transaction_access_list.access_list.storage_keys

string[]

data.transaction.content.flattened_traces

object[]

Show child attributes

data.transaction.content.flattened_traces.error

string

data.transaction.content.flattened_traces.type

string

data.transaction.content.flattened_traces.from

string

data.transaction.content.flattened_traces.to

string

data.transaction.content.flattened_traces.value

string

data.transaction.content.flattened_traces.gas

integer<uint64>

data.transaction.content.flattened_traces.gas_used

integer<uint64>

data.transaction.content.flattened_traces.input

string

data.transaction.content.flattened_traces.output

string

data.transaction.content.flattened_traces.sub_traces

integer<uint64>

data.transaction.content.flattened_traces.trace_address

integer<uint64>[]

data.transaction.content.flattened_traces.trace_type

string

data.transaction.content.flattened_traces.call_type

string

data.transaction.content.flattened_traces.trace_id

string

data.transaction.content.flattened_traces.status

integer<uint64>

data.transaction.content.flattened_traces.block_hash

string

data.transaction.content.flattened_traces.block_number

integer<uint64>

data.transaction.content.flattened_traces.transaction_hash

string

data.transaction.content.flattened_traces.transaction_index

integer<uint64>

data.transaction.content.block_timestamp

string<date-time>

The timestamp of the block in which the event was emitted

Example:

"2023-04-01T12:00:00Z"

data.transaction.content.mint

string

This is for handling optimism rollup specific EIP-2718 transaction type field.

Example:

"0"

data.transaction.content.rlp_encoded_tx

string

RLP encoded transaction as a hex string (prefixed with 0x) for native compatibility with popular eth clients such as etherjs, viem etc.

Example:

"0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"

has_more

boolean

required

True if this list has another page of items after this one that can be fetched.

Example:

true

next_page

string

required

A token which can be provided as page token to retrieve the next page. If this field is omitted, there are no additional pages.

Example:

"eyJsYXN0X2V2ZW50X2lkIjoiMTIzNDU2Nzg5MCJ9"

List smart contract events

⌘I

CDP API V1

REST API

JSON-RPC API

Authorizations

Query Parameters

Response