Coincord Developer Docs

Welcome to the party!

Contact

API Support

[email protected]

API Endpoints
# Staging:
https://api.develop.wallet.coincord.co/graphql
# Production:
https://api.coincord.co/graphql
Headers
# Your foo from bar
Client-Id: <YOUR CLIENT_ID HERE>
# Your foo from bar
Client-Secret: Bearer <YOUR CLIENT_SECRET HERE>

Queries

addresses

Response

Returns [Address]

Example

Query
query addresses {
  addresses {
    id
    address
    app_wallet_id
    created_at
    amount
    token_set
    app {
      id
      name
      client_id
      client_secret
      created_at
      webhook_url
      api_key
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
    token {
      id
      name
      token_set
      ticker
      contract_address
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
    transactions {
      id
      address_id
      recipient
      created_at
      tx_hash
      type
      amount
      status
      address {
        ...AddressFragment
      }
      token {
        ...TokenFragment
      }
    }
    events {
      id
      sender_address
      address_id
      app_wallet_id
      transaction_id
      event
      token_set
      token_id
      token_name
      app_id
      details
      amount
      created_at
      token {
        ...TokenFragment
      }
      address {
        ...AddressFragment
      }
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      transaction {
        ...TransactionFragment
      }
    }
  }
}
Response
{
  "data": {
    "addresses": [
      {
        "id": "xyz789",
        "address": "abc123",
        "app_wallet_id": "abc123",
        "created_at": "xyz789",
        "amount": 123.45,
        "token_set": "NATIVE",
        "app": App,
        "app_wallet": AppWallet,
        "token": Token,
        "transactions": [Transaction],
        "events": [Event]
      }
    ]
  }
}

app

Response

Returns an App

Example

Query
query app {
  app {
    id
    name
    client_id
    client_secret
    created_at
    webhook_url
    api_key
    addresses {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
  }
}
Response
{
  "data": {
    "app": {
      "id": "abc123",
      "name": "xyz789",
      "client_id": "xyz789",
      "client_secret": "abc123",
      "created_at": "abc123",
      "webhook_url": "abc123",
      "api_key": "abc123",
      "addresses": [Address],
      "app_wallet": [AppWallet]
    }
  }
}

apps

Response

Returns [App]

Example

Query
query apps {
  apps {
    id
    name
    client_id
    client_secret
    created_at
    webhook_url
    api_key
    addresses {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
  }
}
Response
{
  "data": {
    "apps": [
      {
        "id": "abc123",
        "name": "xyz789",
        "client_id": "abc123",
        "client_secret": "abc123",
        "created_at": "abc123",
        "webhook_url": "xyz789",
        "api_key": "xyz789",
        "addresses": [Address],
        "app_wallet": [AppWallet]
      }
    ]
  }
}

events

Response

Returns [Event]

Arguments
Name Description
token - String
address - String

Example

Query
query events(
  $token: String,
  $address: String
) {
  events(
    token: $token,
    address: $address
  ) {
    id
    sender_address
    address_id
    app_wallet_id
    transaction_id
    event
    token_set
    token_id
    token_name
    app_id
    details
    amount
    created_at
    token {
      id
      name
      token_set
      ticker
      contract_address
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
    address {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    app {
      id
      name
      client_id
      client_secret
      created_at
      webhook_url
      api_key
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
    transaction {
      id
      address_id
      recipient
      created_at
      tx_hash
      type
      amount
      status
      address {
        ...AddressFragment
      }
      token {
        ...TokenFragment
      }
    }
  }
}
Variables
{
  "token": "xyz789",
  "address": "xyz789"
}
Response
{
  "data": {
    "events": [
      {
        "id": "xyz789",
        "sender_address": "abc123",
        "address_id": "abc123",
        "app_wallet_id": "xyz789",
        "transaction_id": "abc123",
        "event": "abc123",
        "token_set": "abc123",
        "token_id": "xyz789",
        "token_name": "xyz789",
        "app_id": "xyz789",
        "details": "xyz789",
        "amount": 123.45,
        "created_at": "xyz789",
        "token": Token,
        "address": Address,
        "app": App,
        "app_wallet": AppWallet,
        "transaction": Transaction
      }
    ]
  }
}

fee_rate

Response

Returns a FeeRate

Example

Query
query fee_rate {
  fee_rate {
    bitcoin_fee_rate
    litecoin_fee_rate
  }
}
Response
{
  "data": {
    "fee_rate": {"bitcoin_fee_rate": 987.65, "litecoin_fee_rate": 987.65}
  }
}

tokens

Response

Returns [Token]

Example

Query
query tokens {
  tokens {
    id
    name
    token_set
    ticker
    contract_address
    addresses {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
  }
}
Response
{
  "data": {
    "tokens": [
      {
        "id": "xyz789",
        "name": "xyz789",
        "token_set": "abc123",
        "ticker": "xyz789",
        "contract_address": "xyz789",
        "addresses": [Address],
        "app_wallet": [AppWallet]
      }
    ]
  }
}

transactions

Response

Returns [Transaction]

Example

Query
query transactions {
  transactions {
    id
    address_id
    recipient
    created_at
    tx_hash
    type
    amount
    status
    address {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    token {
      id
      name
      token_set
      ticker
      contract_address
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
  }
}
Response
{
  "data": {
    "transactions": [
      {
        "id": "xyz789",
        "address_id": "abc123",
        "recipient": "abc123",
        "created_at": "xyz789",
        "tx_hash": "xyz789",
        "type": "CREDIT",
        "amount": 987.65,
        "status": "PENDING",
        "address": Address,
        "token": Token
      }
    ]
  }
}

Mutations

address__createAddress

Response

Returns an Address

Arguments
Name Description
token_set - TokenCollection!

Example

Query
mutation address__createAddress($token_set: TokenCollection!) {
  address__createAddress(token_set: $token_set) {
    id
    address
    app_wallet_id
    created_at
    amount
    token_set
    app {
      id
      name
      client_id
      client_secret
      created_at
      webhook_url
      api_key
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
    token {
      id
      name
      token_set
      ticker
      contract_address
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
    transactions {
      id
      address_id
      recipient
      created_at
      tx_hash
      type
      amount
      status
      address {
        ...AddressFragment
      }
      token {
        ...TokenFragment
      }
    }
    events {
      id
      sender_address
      address_id
      app_wallet_id
      transaction_id
      event
      token_set
      token_id
      token_name
      app_id
      details
      amount
      created_at
      token {
        ...TokenFragment
      }
      address {
        ...AddressFragment
      }
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      transaction {
        ...TransactionFragment
      }
    }
  }
}
Variables
{"token_set": "BITCOIN"}
Response
{
  "data": {
    "address__createAddress": {
      "id": "xyz789",
      "address": "abc123",
      "app_wallet_id": "xyz789",
      "created_at": "xyz789",
      "amount": 987.65,
      "token_set": "NATIVE",
      "app": App,
      "app_wallet": AppWallet,
      "token": Token,
      "transactions": [Transaction],
      "events": [Event]
    }
  }
}

address__getEstimate

Response

Returns a FeeEstimate

Arguments
Name Description
token - TokenCollection! Default = ETHEREUM
value - Float!
recipient - String!

Example

Query
mutation address__getEstimate(
  $token: TokenCollection!,
  $value: Float!,
  $recipient: String!
) {
  address__getEstimate(
    token: $token,
    value: $value,
    recipient: $recipient
  ) {
    value
    token
    recipient
  }
}
Variables
{
  "token": "ETHEREUM",
  "value": 987.65,
  "recipient": "xyz789"
}
Response
{
  "data": {
    "address__getEstimate": {
      "value": 987.65,
      "token": "BITCOIN",
      "recipient": "abc123"
    }
  }
}

address__sendTokens

Response

Returns a Transaction

Arguments
Name Description
fee_rate - Float!
recipient - String!
sender - String
amount - Float!
token - TokenCollection!

Example

Query
mutation address__sendTokens(
  $fee_rate: Float!,
  $recipient: String!,
  $sender: String,
  $amount: Float!,
  $token: TokenCollection!
) {
  address__sendTokens(
    fee_rate: $fee_rate,
    recipient: $recipient,
    sender: $sender,
    amount: $amount,
    token: $token
  ) {
    id
    address_id
    recipient
    created_at
    tx_hash
    type
    amount
    status
    address {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    token {
      id
      name
      token_set
      ticker
      contract_address
      addresses {
        ...AddressFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
    }
  }
}
Variables
{
  "fee_rate": 123.45,
  "recipient": "abc123",
  "sender": "xyz789",
  "amount": 123.45,
  "token": "BITCOIN"
}
Response
{
  "data": {
    "address__sendTokens": {
      "id": "abc123",
      "address_id": "abc123",
      "recipient": "abc123",
      "created_at": "abc123",
      "tx_hash": "abc123",
      "type": "CREDIT",
      "amount": 987.65,
      "status": "PENDING",
      "address": Address,
      "token": Token
    }
  }
}

app_updateAppDetails

Response

Returns an App

Arguments
Name Description
name - String
api_key - String
webhook_url - String

Example

Query
mutation app_updateAppDetails(
  $name: String,
  $api_key: String,
  $webhook_url: String
) {
  app_updateAppDetails(
    name: $name,
    api_key: $api_key,
    webhook_url: $webhook_url
  ) {
    id
    name
    client_id
    client_secret
    created_at
    webhook_url
    api_key
    addresses {
      id
      address
      app_wallet_id
      created_at
      amount
      token_set
      app {
        ...AppFragment
      }
      app_wallet {
        ...AppWalletFragment
      }
      token {
        ...TokenFragment
      }
      transactions {
        ...TransactionFragment
      }
      events {
        ...EventFragment
      }
    }
    app_wallet {
      id
      app_id
      token_name
      token_set
      token_id
      created_at
      balance
      app {
        ...AppFragment
      }
      addresses {
        ...AddressFragment
      }
      transactions {
        ...TransactionFragment
      }
    }
  }
}
Variables
{
  "name": "abc123",
  "api_key": "abc123",
  "webhook_url": "abc123"
}
Response
{
  "data": {
    "app_updateAppDetails": {
      "id": "xyz789",
      "name": "abc123",
      "client_id": "abc123",
      "client_secret": "xyz789",
      "created_at": "abc123",
      "webhook_url": "abc123",
      "api_key": "xyz789",
      "addresses": [Address],
      "app_wallet": [AppWallet]
    }
  }
}

Types

Address

Fields
Field Name Description
id - String!
address - String!
app_wallet_id - String!
created_at - String!
amount - Float!
token_set - TokenSet!
app - App!
app_wallet - AppWallet!
token - Token!
transactions - [Transaction]
events - [Event]
Example
{
  "id": "abc123",
  "address": "abc123",
  "app_wallet_id": "abc123",
  "created_at": "abc123",
  "amount": 123.45,
  "token_set": "NATIVE",
  "app": App,
  "app_wallet": AppWallet,
  "token": Token,
  "transactions": [Transaction],
  "events": [Event]
}

App

Fields
Field Name Description
id - String!
name - String!
client_id - String!
client_secret - String!
created_at - String!
webhook_url - String
api_key - String
addresses - [Address]!
app_wallet - [AppWallet]!
Example
{
  "id": "abc123",
  "name": "xyz789",
  "client_id": "abc123",
  "client_secret": "abc123",
  "created_at": "abc123",
  "webhook_url": "xyz789",
  "api_key": "xyz789",
  "addresses": [Address],
  "app_wallet": [AppWallet]
}

AppWallet

Fields
Field Name Description
id - String!
app_id - String!
token_name - String!
token_set - String!
token_id - String!
created_at - String!
balance - Float!
app - App!
addresses - [Address]!
transactions - [Transaction]!
Example
{
  "id": "xyz789",
  "app_id": "xyz789",
  "token_name": "abc123",
  "token_set": "xyz789",
  "token_id": "xyz789",
  "created_at": "abc123",
  "balance": 987.65,
  "app": App,
  "addresses": [Address],
  "transactions": [Transaction]
}

Boolean

Description

The Boolean scalar type represents true or false.

Example
true

Event

Fields
Field Name Description
id - String!
sender_address - String
address_id - String
app_wallet_id - String
transaction_id - String
event - String!
token_set - String!
token_id - String!
token_name - String!
app_id - String!
details - String
amount - Float!
created_at - String
token - Token!
address - Address
app - App!
app_wallet - AppWallet
transaction - Transaction
Example
{
  "id": "xyz789",
  "sender_address": "xyz789",
  "address_id": "xyz789",
  "app_wallet_id": "xyz789",
  "transaction_id": "abc123",
  "event": "abc123",
  "token_set": "abc123",
  "token_id": "xyz789",
  "token_name": "abc123",
  "app_id": "xyz789",
  "details": "xyz789",
  "amount": 123.45,
  "created_at": "abc123",
  "token": Token,
  "address": Address,
  "app": App,
  "app_wallet": AppWallet,
  "transaction": Transaction
}

FeeEstimate

Fields
Field Name Description
value - Float
token - TokenCollection
recipient - String
Example
{
  "value": 987.65,
  "token": "BITCOIN",
  "recipient": "abc123"
}

FeeRate

Fields
Field Name Description
bitcoin_fee_rate - Float!
litecoin_fee_rate - Float!
Example
{"bitcoin_fee_rate": 123.45, "litecoin_fee_rate": 123.45}

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example
987.65

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"xyz789"

Token

Fields
Field Name Description
id - String!
name - String!
token_set - String!
ticker - String!
contract_address - String
addresses - [Address]!
app_wallet - [AppWallet]!
Example
{
  "id": "abc123",
  "name": "xyz789",
  "token_set": "abc123",
  "ticker": "xyz789",
  "contract_address": "abc123",
  "addresses": [Address],
  "app_wallet": [AppWallet]
}

TokenCollection

Values
Enum Value Description

BITCOIN

LITECOIN

ETHEREUM

DAI

USDC

USDT

Example
"BITCOIN"

TokenSet

Values
Enum Value Description

NATIVE

ERC20

ERC721

Example
"NATIVE"

Transaction

Fields
Field Name Description
id - String!
address_id - String
recipient - String
created_at - String!
tx_hash - String
type - TransactionFlow!
amount - Float!
status - TransactionState!
address - Address
token - Token!
Example
{
  "id": "abc123",
  "address_id": "abc123",
  "recipient": "xyz789",
  "created_at": "xyz789",
  "tx_hash": "xyz789",
  "type": "CREDIT",
  "amount": 123.45,
  "status": "PENDING",
  "address": Address,
  "token": Token
}

TransactionFlow

Values
Enum Value Description

CREDIT

DEBIT

Example
"CREDIT"

TransactionState

Values
Enum Value Description

PENDING

SUCCESSFUL

FAILED

Example
"PENDING"